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WELCOME I 


WELCOME 

to The MagPi 81 


B uilding a Raspberry Pi project sounds so simple. Take your 

favourite single-board computer, add a few parts, sprinkle some 
code, and share your creation with the world. 

With a few components, you can turn a Pi into a weather station, 
or a camera, or a wheeled robot. Building projects is what The MagPi 
magazine is about; it’s what the Raspberry Pi community is about. It’s 
what brings us together. 

The challenges in project building are as much psychological as 
physical. Where do you get good ideas from? How do you get started? 
What makes for a good project look? And how can you make sure it 
solves a problem (and does so well)? 

This month, we look at the nuts and bolts of project planning, 
building, and execution (page 26). We’ve asked some of the 
community’s greatest makers to share tips and tricks. What makes a 
really great project; what kit should you have; how to plan and execute 
a project for maximum effect. 

The result is a classic tutorial that gets right to the heart of what 
it means to be a maker in the 
modern world. We’re delighted 
with this month’s feature and 
found it remarkably helpful. We 
hope you do too. 


Lucy Hattersley Editor 



Editor of The MagPi. 
Lucy codes, crafts, 
and creates wonky 
robots. She speaks 
French (badly) and 
mangLes the piano. 
One day shell get 
that pet dog. 
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hosts successful 
space mission 

Robot-roustabout more challenging and engaging than ever, By Rosie Hattersley 


A A robot navigates 
the Spirit of 
Curiosity terrain 
Credit: Sim UK 

^ Pushing the puzzLe 
obstacle on the 
ApoLLo 13 course 
Credit: Sim UK 



P i Wars has always had a great set of 
ingredients: Raspberry Pi-powered 
vehicles customised or designed from 
scratch, challenging courses, and a multitude of 
opportunities to pit your personal Pi-bot against 
similarly competitive souls. Spread over two days, 
there are school, individual, and team categories, 
neatly encouraging entrants from newbies to near¬ 
veteran robot builders to take part. 

Or, like us, you can just go along and cheer 
on all-comers. Nearly 500 spectators attended 
this year and enjoyed watching more than 250 
entrants from all over the globe take on seven 
different challenge courses. 
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A BiLLy CorteiL's Space Babbage takes on the Asteroid FieLd 
Credit: Sim UK 


Robots in space 

In honour of the 50th anniversary of the Apollo 
Moon landing, this year's Pi Wars event - held 
at Cambridge Computer Laboratory, on 30 and 31 
March - was space-themed. As ever, competition 
places were snapped up months ago and 
serious building undertaken, not least because 
organisers Tim Richardson and Mike Horne 
warned Pi Wars 2019 would be more challenging 
than ever. Mike said many competitors embrace 
the space theme “with everything from a Mars 
Rover-alike rocker bogey system to a robot that 
looked like Starbug from Red Dwarf.” 

□ Many a Pi-bot came □ 
cropper on the travellator 
built by PiBorg □ 

The rough terrain, remote control fetch- 
and-carry challenge Spirit Of Curiosity, and the 
autonomous maze navigation task Canyons of 
Mars were popular additions to what was the 
fifth Pi Wars event. The former was crafted 
from plaster, wood, and bandages by course¬ 
building supremo Tim. Another stalwart, target 
hitting, became an eighties Space Invaders retro 
gaming corner. 

One existing course got a surprisingly 
tricksy tweak to become the ‘freshly kinked' 
Straight(ish) Line Speed Test, while Mike tells 
us that competitors found the Hubble Telescope 
vision course especially challenging. 



Raspberry Pi 3B+ gets a new 
outlook 


Versatile enclosure system for 
Raspberry Pi 3B+ 


The USC-RPI Universal Case System 
securely holds the Raspberry Pi 3B/+ & 
official 7” touchscreen with lots of room 
for additional electronics. 

Available in 2 colours, 4 sizes & 2 heights 
with optional wall, desk & DIN rail 
mounting adaptors. 



For additional information call 0845 881 2222 or visit 

phoenixcontact.co.uk/UCS 
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A PiDrogen about to 
take on traveLLator 
Credit: Christopher 
Parrot 

^ We were also 

delighted with John 
Chinner's Yuri 3 Mars 
Rover replica, and the 
Featherstone Rover 
and Rocky Rover 
Credit: Harry Bren ton 



Many a Pi-bot came a cropper on the 
travellator built by PiBorg as part of the Apollo 13 
Obstacle Course, and was hurled off into a canyon 
to lick its electronic wounds. Head-scratching 
also ensued later in the same course at Coretec 
Robotics’ puzzle section. 

Meet thejudges 

Dr Lucy Rogers once again honoured Pi Wars as 
head and technical judge, while Raspberry Pi 
founder Eben Upton was ably assisted in his Pi 
Noon judging capacity by two-year-old daughter 
Aphra. Pi Noon always draws a crowd, with 
spectators jostling for room on the two galleries 
above the jousting area. More than 100 balloons 
were sacrificed at Pi Noon, says Mike. 

Pi Wars isn’t just about competition, though. 
It’s also a marketplace for Raspberry Pi vendors 
such as The Pi Hut (thepihut.com) and Pimoroni 
(pimoroni.com), as well as a showcase for more 
advanced robots such as SB Components’ PiArm 


▼ Mike and Tim handing out the awards Credit: Colin Grant 



Pi Wars 2019 winners 


Mike and Tim would like to extend thanks to Dr 
Lucy Rogers for being head judge again this year, 
and more than 70 volunteers who helped make the 
event possible. 

Competitors represented ten different countries, 
including Turkey, Nigeria (which had three teams 
in attendance), Malaysia, China, Hong Kong, and 
Australia, as well as Scotland, England, and Wales. 
Competitors received Arduino-based badges made 
by Gareth Davies at 4tronix. Gareth also made the 
large circuit-board-based trophies. 

There were 37 school teams - for the first time, 
every single school team actually showed up on the 
day - and 37 individual teams on the Sunday. All the 
winners were first-time champions. 

• Schools (novices) - Lunokhod 1 

• Schools (experienced) - Bobby Tables 

• Beginners - Crumble 

• Intermediate - PiDER 3.0 

• Advanced - PiDrogen 

• Technical Merit - Bobby Tables (Saturday); 

Coretec Robotics / Face Plant (Sunday) 

• Artistic Merit - Latymer Space Pigs (Saturday); 

Mini Mouse (Sunday) 

Mike and Tim were awarded their own Pi Wars 
trophy and specially commissioned (a)smolrobots 
artworks, and were given leisure vouchers so they 
could take their long-suffering wives away for a 
much-needed break. 


and PiMecha (sb-components.co.uk). We were 
also delighted by PiBorg’s new three-wheeled 
RockyBorg robot (look out for more news on this 
one soon, piborg.org). 

Tim and Mike are currently weighing up 
options for future events, and they are asking 
folks to sign up for the Pi Wars newsletter 
for more information on the next event: 
piwars.org/mailing-list. ED 
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Young refugees get 

started with Code Club 

Children of families who have resettled in Cambridge are learning 
new tech skills, reports Rosie Hattersley 


A Nina Szymor 

supporting a member 
of her Code CLub 


R aspberry Pi Jams and Code Clubs often 
come about when a group of tech 
enthusiasts get together and decide 
they want to share ideas with each other or at 
school. But you don’t have to be a teacher or tech 
evangelist. You can simply learn as you go. 

This is exactly what’s been happening at 
a Code Club in Cambridge, which was set up 
by Nina Szymor, translation manager at the 
Raspberry Pi Foundation, in collaboration with 
Cambridge Refugee Resettlement Campaign 
(CRRC, magpi.cc/sNKqKw). 

Nina set up the twice-monthly club with no 
technical expertise, but armed with plenty of 
Code Club resources and supported by a group 


of volunteers. She became involved due to her 
own volunteering efforts with CRRC and saw 
an opportunity to help children of families who 
have resettled in Cambridge to learn valuable 
new skills. “I don’t have a technical background 
or experience working with kids; I needed some 
support and guidance,” reveals Nina. With a 
keen crew of youngsters eager to learn, she set 
about learning on a project-by-project basis so 
she could show the club members how to work 
through them themselves. “I love seeing the 
pure joy on children’s faces when they make 
something work,” she adds. 

The club takes place at the Raspberry Pi 
Foundation offices in central Cambridge. “Seeing 


10 | magpi.cc | Young refugees get started with Code CLub 


THE WORLD OF PI I 



□ I love seeing the pure joy on children's faces 
when they make something work □ 


▲ The children can 
Learn computing and 
develop valuabLe 
skills while having fun 


the amazing work we do as an organisation 
inspired me to take personal responsibility for 
giving children the opportunity to experience 
coding and technology/' says Nina. 

When the club started in September 2018, 
many of the children had never used a computer 
mouse; now that original cohort has mastered 
Module 1 of Scratch. Nina held an end-of- 
term certificate ceremony to which their proud 
families were invited. 

A lack of pre-existing computing skills 
was only one barrier. Some attendees are 
still learning English, but were ably helped 


by children who had already attended several 
sessions. One girl stepped in and showed 
newcomers how to use Scratch and how to make 
best use of the Code Club materials. It's often 
said that one of the best ways of embedding your 
learning is to show someone else what you've 
been taught. This Code Club is proof positive. 

“All the resources are handed to you, and 
you are guided by the Code Club team,” 

Nina reassures anyone keen to replicate her 
example and set up a Code Club too. If that 
sounds like you, head to magpi.cc/hBfadS to find 
out more. EH 
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Sean 

Glendinning 


Sean's Robot 

Edge detecting, face detecting, and voice-controlled 
- this happy robot can do it all. Rob Zwetsloot finds 
oat more about it 


A 16-year-old 
S4 student from 
Aberdeenshire 
who enjoys 
physics, maths, 
and programming. 


R obots with faces don’t always work, we 
find. Sometimes they can be just creepy. 

Sean Glendinning’s robot is a bit different, 
though, in that it’s kinda cute. Which is great, 
as due to its face-sensing capabilities it will 
sometimes look at you. 



“For my Gold CREST Award project, I decided 
to design and build a robot powered by the 
Raspberry Pi computer system,” Sean tells us. 
“The robot is able to detect edges, faces, and 
some voice commands. It moves around on 
caterpillar tracks and if it detects a face, it reacts 
by tilting its head.” 

CREST (crestawards.org) is a scheme to get 
young folks into STEAM subjects by contributing 
something much more real and practical than you 
would at school. Apparently, a gold award project 
can take more than 70 hours to complete. 

“This was a challenging build, but it was really 
fun and I learned a lot,” Sean continues. “I 
designed the 3D-printed chassis myself, using 
skills I learned in graphic design at school. I had 
quite a lot of the required electronic components 
already, and I tried to improvise where I could 
to keep costs down. There are some special 
components, though, like a USB microphone and 
the 3D-printed chassis, that I had to buy online. 
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Quick FACTS 






Distance sensors 


The robot s chassis 
is entirely custom 
3D-designed 
and printed 


beneath the robot 


and on its front 
detect if there's 
a wall or sudden 


drop ahead 


> The Pi Zero W used 
is from The MagPi 
subscription offer 


► The square design is very 
practical, and shows off a 
Lot of its functionality 


>The design is 
inspired by the Anki 
Vector robot 


> Camera vision on 
the Raspberry Pi 
can be achieved 
via OpenCV 


> There are four 
IR sensors on 
the robot - two 
on the front, 
two underneath 


▼ Its guts are packed with 
hardware that is quite 
neatly arranged 


> The CREST awards 
are open to all UK 
schoolchildren 
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▲ Every good robot 
needs a nice Livery 


I tried to make the robot have a friendly design 
and personality, and able to move around without 
bumping into things.” 


From arms to tracks 

Sean has been building robots for years, albeit 
much simpler robot arms - the kind you see in 
factories building cars, or as Pi kits like MeArm 
Pi and PiArm. 

“The first one I built in 2015, was made of 
plywood and held together with glue,” Sean 
recalls. “The second one was made of laser-cut 


▼ As well as a lithium battery, 
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acrylic plastic. Neither of these arms actually 
worked, as they were both quite badly designed. 
The third arm was built in 2018, and I spent three 
months designing it. It was made of thick plywood 
and aluminium braces, which held together a lot 
better than the other two arms. ” 


▲ A table is its natural habitat 


Main Chassis 


r - 

Caterpillar track 

.i, 


Ground 


□ I had quite a lot of the required electronic 
components already, and I tried to improvise 
where I could to keep costs down □ 


The Raspberry Pi is constantly monitoring the 
IR sensors via the GPIO header, and runs the 
results via the software. 


After being inspired by a toy robot, Sean decided 
to build a more mobile kind of robot using a 
Raspberry Pi. 

“I have used the Raspberry Pi for a number 
of projects, and knew that an Arduino wouldn’t 
be powerful enough for speech or face 
recognition,” he reveals. “For its size and cost, 
the Raspberry Pi has a powerful processor and 
was able to handle the complicated speech and 
face detection libraries.” 

The robot uses IR distance sensors arranged 
around the chassis for its edge/wall detecting, 
along with a Raspberry Pi Camera Module 
for face detection, all housed within its own 
3D-printed case. We think it’s a great build, and 
look forward to seeing what robots Sean makes 
in the future. ED 



I moving the robot backwards, then turn the motors so 
the robot faces a different direction. 
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The audio sources are GTA: San 
Andreas’s in-game radio stations, 
featuring music (over many 
genres), talk-shows, and comedy 


This classic Optalix TOioo radio 
retains its original speaker, 
allowing a more authentic sound 


San Andreas 
Radio Set 


The original controls are replaced by two 
rotary encoders: one for volume and another 
to ‘tune’ between the various stations 



Raphael 

Yancey 


Raphael Yancey is a 
maker and musician 
from Paris, France, 
with a keen interest 
in programming, 
electronics, 
and music. 

magpi.cc/VrTLVp 


This vintage radio plays GTA's radio stations, all in 
real-time, You can even tune between them, 

PJ Evans talks to maker Raphael Yancey 


T he ‘Raspberry Pi in a vintage radio’ 

project is a stalwart of the community. 

Pi computers the world over have rescued 
otherwise defunct devices from the rubbish 
heap and are often cited as a great example of 
upcycling. When Raphael Yancey, a maker from 
Paris, France, was gifted his grandfather’s Optalix 
TOioo radio, he decided to take this classic project 
to the next level. 

Raphael’s love of Grand Theft Auto: San 
Andreas’s in-game radio stations inspired him. 
“It’s always a pleasure to steal luxury cars and 
drive way too fast while listening to good music! 
The hilarious talk-shows and skits make it even 
more real,” he tells us. When the complete set of 
station recordings was released by Rockstar, some 
new ideas for a project started to form. 


He explains, “I thought of a way to listen to the 
radio stations ( in context’ without launching the 
game. A radio set was the perfect choice, because: 
first, I had a spare one on hand; second, being 
able to move between the stations would make it 
real, like it’s taken right out of the game.” 

Touch that dial 

Raphael’s radio plays five stations from the game 
in real-time. The radio features a Tuning’ knob 
(a rotary encoder) that switches between each 
station, complete with cross-fade. When you’re 
listening to one station, the others continue 
to play silently, making for a more realistic 
experience. a I was really looking forward to 
turning that knob, changing station, and then 
coming back to the first station to see it has 
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▲ Inside the radio. Note the stripped- 
down USB audio card used to offload 
the audio processing 

► One of the two KY040 rotary 

encoders used to control the radio 


> The project can 
run for hours on 
batteries 


lived its life without me listening to it! That little 
feature is what makes it real in my opinion.” 

Channels funnel 


> There are five 
stations, from 
88.7MHz to 
108.0MHz 


> This radio used 
costs around £20 
on auction sites 


The hardware side of this inspiring project was 
straightforward enough: a Raspberry Pi 3, two rotary 
encoders (tuning and volume), with an amplifier to 
power the original speaker. The challenges lay in 
the software. The Pi would have to be playing five 
channels concurrently, one per station. Would it 
be able to handle it? “The audio was really glitchy 
when playing multiple files with the built-in 
Raspberry Pi DAC,” recalls Raphael, “so I bought a 
cheap USB DAC (kind of a sound-card-on-a-stick) 
to offload this work. ” 

A further challenge was to be able to elegantly 
cross-fade between each station, rather than a 
straight, jarring cut. “I also struggled to find an 
audio mixer Python library that fitted my needs 
(controlling volume and position of multiple 
audio tracks) and benchmarked all of them before 
choosing swmixer.” 

After some maths to work out an elegant 
‘fade’, the project was complete. A hit with 
the community, it was featured on many 
popular maker sites, including the Raspberry Pi 
Foundation’s blog. 

Are there any further plans for the radio? “A 
feature that was requested a lot was to add static 
between stations to make it even more real,” 


> The rotary encoders 
are the popular 
KY040 type 

> Raphael wrote a 
Python library for 
the KY04OS 


A With the speaker removed, 
we can see an elegant 
power solution which offers 
more flexibility over the 
Pi's location 

□ Being able to move between the stations 
would make it real, like it's taken right 
out of the game □ 

says Raphael. “I could also optimise the code to 
not play every track at the same time and rather 
only play audible stations. In the meantime, 
every contribution is welcome on the GitHub 
repository: magpi.cc/wDBwEN.” ED 
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Commodore 

monitor 


Testing the notion that good things come in small 
packages, this tiny replica monitor was created for 
Commodore 64 gaming, David Crookes reports 



Chris 

Mills 


Chris has had 
an interest in 
computers since 
the Late 1970s. He 
got a Commodore 
128 in 1985, and 
says he Likes getting 
things to work as 
much as actuaLLy 
using them. 

magpi.cc/VKPkzy 


► No, that's not a 
huge joystick: it's a 
standard size, but 
it shows just how 
smaLL the monitor 
is. THEC64 Mini sits 
in front 


O ver the years, the Raspberry Pi has become 
a firm favourite among enthusiasts of 
retro gaming, thanks to its ability to 
emulate classic computers and consoles from a 
bygone era. Many use packages such as RetroPie 
to create machines capable of playing games from 
multiple systems. These are usually hooked up to 
the makers’ big-screen televisions. 

When Chris Mills decided to emulate the 
Commodore 64, however, he had smaller 
ambitions. Inspired by the recently-launched 
miniature, THEC64 Mini, he set about producing 
a tinier version of the age-old Commodore 1702 
monitor. Or at least he did eventually. “The 
original idea was to make a small box to hold the 
monitor and a Raspberry Pi strictly for Commodore 
emulation,” he says. “I wasn’t really planning on 
making it quite as elaborate as it turned out to be. ” 

Mini marvel 

Chris likes the Raspberry Pi, which is why, 
despite buying THEC64 Mini and enjoying its 
plug-and-play nature, he prefers using the Pi for 
his Commodore 64 games. “I can get a lot more 
software to run on it,” he tells us. This is mainly 




▲ CabLes run from the circuit board of the monitor to the back 
of the new case, so that the connectors are easiLy accessible. 
Components are cooled by a fan 


□ You wouldn't believe how 
loud □ 'silent' 50mm fan is 
in a box that size □ 

due to him running the Combian 64 emulator, 
which is a distribution based on an app called Vice. 

“Its single purpose is Commodore emulation, 
and it boots from a cold start to the blue 
Commodore screen in just a few seconds,” he 
explains. “It seems a bit closer to the real hardware 
experience of a Commodore computer to me and 
control seems far less laggy.” Hooked up to the 
monitor and with the mini-C64 to its side, along 
with a joystick, it makes for an impressive setup - 
in appearance alone if nothing else. 

Security monitor 

To achieve the look, Chris chose a small TFT LCD 
security monitor. “It needed to have a 43 aspect 
ratio since the display would be for a computer 
with 320x200 resolution,” he says. “I also wanted 
something that would sit on my desk without 
taking up too much space. I can’t imagine a 
Commodore 64 displaying on a 32-inch television, 
and I grew up with a 13-inch CRT for my computers 
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> The project cost a 
total of $120 


***** 
64K RAM 

Ready. 


COMMODORE 
SYSTEM 3! 


The Commodore 64 was 
renowned for its SID music chip 
that deserve to be heard at their 
best. "I may add a headphone 
jack to connect to a larger 
sound system," Chris tells us 


Thanks to Combian 64 , Chris 
found there was nothing 
to do except configure the 
display and fiddle with the 
emulation settings 


Hum 

'-Oc/f 


Chris would like to use the Pi’s GPIO pins 
to light an LED to show data transfers, 
but he’s happy his Pi/monitor combo 
lets him play his favourite C 64 games 


Quick FACTS 


so an 8-inch size seemed like a nice compromise 
for space versus readability. ” 

The HD monitor was placed inside a wooden 
case which Chris designed and crafted himself. He 
removed the back of the display, connected wires 
to the newly created back of the retro monitor, and 
wired a pair of two-inch speakers - which proved 
the trickiest part. 

“I didn’t find out that the speaker mounting 
holes and the bezel holes didn’t line up until I 
went to put the speakers in the enclosure,” he 
says. He also added a series resistor to drop the fan 
voltage from 12 V to 4V. “You wouldn’t believe how 
loud a ( silent’ 50mm fan is in a box that size,” he 
laughs. “All these years, I’ve been mistaken in my 
interpretation of the world ‘silent’.” 

For the finishing touch, the box was fine- 
sanded as smoothly as possible and painted using 
Krylon spray enamel, wet-sanded with 2000 grit 


paper between coats. Chris then took a photo of 
a Commodore badge from one of his real 1702 
monitors. “I cropped the picture and made a metal¬ 
looking Commodore logo,” he says. This was placed 
on the front of the mini monitor. “It’s had a great 
reaction from Commodore fans. ” D 



> It took around 25 
hours to make 

> The case is made 
of painted wood 

> The Pi uses the 
C64 emulator, 
Combian 64 

> Currently, the Pi sits 
outside the monitor 


M Front and back, the 
monitor looks like a 
professional Labour 
of love, with a nice 
retro-style finish 


Commodore monitor 
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Joe 

Birch 


Chord Assist 

With a built-in Al voice assistant, this accessible smart 
guitar can help almost anyone learn to play, Phil King 
starts strumming 




Joe is an Android 
engineer working 
remotely at Buffer, 
currently from 
Brighton in the UK. 
He is also a Google 
Developer Expert 
in Android, Google 
Pay, and Flutter. 

i chordassist.com 


L earning to play the guitar can prove 

difficult for people with sight or hearing 
loss. Joe Birch’s accessible Chord Assist 
guitar is intended to make the process a whole lot 
easier for deaf, blind, and mute people. 

In Joe’s family runs a condition known as 
retinitis pigmentosa, which causes tunnel vision 
over time; it has affected his mother, who is 
now registered partially sighted. “Being closer 


□ Cutting the holes in the guitar and 
then putting all of the parts inside 
became quite a tedious taskD 


The Raspberry Pi 


and other electronic 


components are 


hidden inside the 


guitar body, without 


greatly affecting 


its sound 


to people who have this condition opened up my 
awareness of how it can effect peoples lives,” 
explains Joe. “Currently, music is something that 
is not so accessible to everyone, so I started to 
think of ways in which it could become accessible 
- which is where the idea for Chord Assist 
came from.” 

As well as an LCD screen, four-digit display, and 
buttons to show and select chords, Joe’s modified 
acoustic guitar features a Braille reader based 
on his earlier BrailleBox news-reader project 
(magpi.cc/LpjrGF). There’s even a vibrating 
progress indicator next to the reader, to indicate 
when a request is taking place. 

In addition, the user can make a spoken request 
for a chord using the built-in mic and Google- 
based voice assistant, and hear a response via 
the speaker. Also capable of playing a requested 
note for tuning purposes, this system makes use 
of Joe’s Chord Assist app (magpi.cc/xUAQNo) on 
the Actions on Google platform, which can also be 
used as a standalone learning aid on smartphones 
and other devices. 

Hidden components 

The whole project took Joe around six months 
to complete. “The most difficult part was 
definitely the last stages of the build process - 
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cutting the holes in the guitar and then putting 
all of the parts inside became quite a tedious 
task,” he recalls. “I originally had everything 
on prototyping boards, but components kept 
coming unplugged. Because of this I decided to 
solder everything properly on PCB boards, which 
improved everything here.” 

All the electronic components, including 
a Raspberry Pi, are secreted inside the body 
of the guitar. “There’s actually a lot of stuff 
in there, but none of it is that heavy other 
than the portable battery pack.” It doesn’t 
seem to have an adverse effect on the sound 
quality either: “Initially I thought it was going 
to be a big problem, but when comparing it 
against my other guitar, there isn’t really 
much difference.” 

Turn it up 

While Joe is happy with the project, he’s planning 
a few tweaks. “I’d like to add an amplifier and 
volume control to improve the functionality 
of the speaker. Another thing I’d like to add is 
real guitar tuning functionality - so something 
in the software that will analyse the note played 
and let the user know if the string needs to be 
tuned higher or lower. This isn’t yet possible 
with the Google Assistant, but would be a useful 
feature for users who might not have experience 
with tuning a guitar. I could also make use of the 
screen to instruct the user here and cater for the 
different accessibility needs.” 

If you’d like to have a go at creating a similar 
project, Joe has open-sourced most of what is 
needed to build the guitar, apart from the program 
that runs on the Raspberry Pi which drives the 
user interface and GPIO for the components. 

“The wiring diagram and conversational hot are 
open-source, so someone could build it if they 
wanted to.” 

Following feedback from users, Joe plans to 
iterate on the design to create more smart guitars. 
Since this project has struck a chord with us, 
that’s music to our ears! ED 


▲ The Braille reader on the 
other side of the guitar 
enables blind users to read 
instructions on how to play 
a chord 


▲ The Pi and other 
components, 
including an eight- 
channel relay for 
the solenoids in the 
Braille reader, are 
stuffed inside the 
body of the guitar 

M Extensive controls 
and features 
include selection 
buttons, a mic and 
speaker, along with a 
segment display and 
LCD screen 


> Chord Assist has 
been nominated for 
a Webby award 

> The screen, Braille 
reader, and speaker 
can each be turned 
on/ofF individually 

> There’s a button 
to quickly repeat 
the last returned 
voice response 

> A four-digit 
segment display 
shows available 
chords,,. 

> Buttons below it 
can be used to 
select a chord, 
instead of speaking 
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The Intelli-T 
Raspberry Pi 
Sensor Alarm 


Never knowingly run out of tea-bags again with 
this ingenious system, Nicola King investigates,,, 
with a cuppa at her side, of course! 


Robin 

Mitchell 


Based in the UK, 
when not making 
and creating, 
Robin owns a 
small electronics 


□ One of the biggest problems that faces 
many British homes, as well as my own, 
is having a stable supply of tea □ 


F aced with the, almost unthinkable, problem 
of no tea-bags in the house, Robin Mitchell 
was inspired to contrive an invention that 
would eliminate the possibility of that scenario ever 
happening again, and the Intelli-T Raspberry Pi 
Sensor Alarm was born. As he explains, a One of the 
biggest problems that faces many British homes, as 
well as my own, is having a stable supply of tea... an 


business, and he 
also contributes to 
various websites 
with bLog posts and 
how-to tutorials. 


issue with knowing how many tea-bags are available 
in the house. Hence, an intelligent tea-bag container 
was needed!” 


magpi.cc/FfbhNF 


Simplici-tea 

Simple in its design, the project consists of only a 
few elements, as Robin tells us: “The first element 
is the weight sensor itself, which weighs the 
tea-bag container. This weight sensor is connected 
to a standard HX711 ADC, which is then read by an 
Arduino. The Arduino then sends the weight data to 
the Raspberry Pi, which can keep track of how many 
bags there are, and play interesting facts about tea 
when a tea-bag is removed. ” 

Clever, but as with many inventions, not entirely 
straightforward to construct, with the weight sensor 
providing the main issue, as Robin elaborates: “The 
problem with weight sensors is that they require 
plenty of fine-tuning and can be very noisy. While 
this is not a problem for heavier items, trying 
to accurately weigh tea-bags is a nightmare. On 


reflection, it would have been better to use a much 
smaller weight sensor, so that the weight of the 
individual tea-bags is larger with respect to the 
minimum weight that the sensor can register (this 
would improve the accuracy).” 

Brewing ideas 

Undeterred, Robin successfully completed his 
tea-bag detection system, and feels that this 
kind of weight-sensing system could easily 
be used in other projects. “One area that 
could benefit from a similar system would be 
industrial systems that need to count parts such 
as resistors, transistors, capacitors, and even 
potentiometers. Of course, part counting can 
also be useful for the everyday hobbyist who 
wants to keep check of their component stock, 
and someone like myself who stocks many 
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> The Pi code was 
written in Python 


> A reed switch 
senses the 
Lid opening 


charbrew 


> The weight sensor 
needs to be 
calibrated first 


> It plays audio 
responses, 
including eight 
tea facts 


TREBLE 


> His other Pi projects 
include a savings 
machine and a 
home automated 
butler system! 


PROJECT SHOWCASE 


Quick FACTS 


A load sensor is used to 
weigh the tea caddy and 
its contents 


fell 







m Ah 
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thousands of parts needs to keep an accurate 
check on inventory regularly (as I own a small 
electronics business).” 

There certainly appears to be some scope here 
for future projects but, as for tea-bag detection, 
Robin thinks he has taken that particular piece of 
work as far as he can. “The project was great fun, 
but since I no longer drink bagged tea (lemon tea 
rules!), I don’t have a use for it any more.” 

Not that Robin is short of ideas for other 
projects. “Each day of my life is all about creating 
projects around many platforms, with the 
Raspberry Pi included. Only recently, I designed 
a simple IoT monitoring station for an IoT sensor 
that can be affixed to a drill, and the vibration data 
streamed to the Raspberry Pi via a local network. 
All I can say is that the Raspberry Pi is a fantastic 
platform for prototyping and project building! ” 19 
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withdrawal at any time 
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ongratulations, you’ve bought a Raspberry 

Pi. You’ve hooked it up and had a go, but 
reached the limit of the interesting stuff on 
the desktop. You’re ready for some hardware, to 
make your Pi do something interesting! 

The Pi is a good place to start with your own 
hardware projects, with the perfect combination of 
interfaces alongside the best documentation and 
support community in the field. Most computers 
don’t sit on desks; instead, they take measurements 
and control machines. So, by bringing your Pi into 
the things you make, you’re taking the first step 
into the exciting world of embedded computing. 
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You may have seen some really cool Raspberry 
Pi hardware projects, but when you take a closer 
look they seem impossibly complex. It’s all rather 
daunting, but fear not: it’s simpler than it looks. 

The functions of any embedded computing project 
can be split three ways. The computer measures 
inputs, it uses software to think what it will do with 
those measurements, then it makes something 
happen with the result. If you see a project you’d 
like to make, then splitting it into those three parts 
makes it much simpler to understand. 

Taking a look at those inputs, just how does a 
computer measure something? The answer is that 
it asks a sensor connected to one of its inputs, and 
receives the reading. That sensor can be as simple 
as a push-button; a bit more involved, such as a 
temperature sensor; or very complex, for example 
the Pi Camera Module. It doesn’t even need to be 
physical hardware - for instance, a feed of the 
temperature in Miami from the internet or the 
current time from the Pi’s clock could both be 
inputs. The information they return can then be 
fed to the software for the thinking stage. 

Software, the code you write, can be extremely 
simple or very complex, but its function is always 
to take the information from the inputs and apply 
a set of conditions to it to decide what to do. As 
examples, a piece of software could send an output 
to an LED only when both of two buttons have been 
pressed, or it could make the decision on when 
to move a robot based upon whether a proximity 
sensor detects any obstacles. 


Finally, with the inputs read and the decisions 
made by the software, the computer must do 
something. For that it needs outputs, things that 
transfer from the software to the real world. These 
can be as simple as an LED; a bit more demanding, 
such as a servo in a robot; or very complex, such as 
the mechanism of a 3D printer. Again, they don’t 
even need to be physical - for example, a piece of 
software can send a Tweet as its output. 

What type of project you create is up to you, 
be it just for fun or to solve a practical problem. 
There are plenty of complete project tutorials out 
there, in the pages of The MagPi or on the web, so 
we won’t stifle your creativity here by telling you 
what to make or how to make it. Instead, we’ll try 
to help you with your own ideas, by showing you 
some of the electronic and software building blocks 
you’ll need to make them happen. 


T 


The Pi GPIO 
40 pins, but 


expansion header only has 
many more than 40 functions 




“Don't be footed 
into thinking you 
need breadboards 
and fiddly resistors 
to use the Pi 
as a maker. My 
breakthrough 
came when I Learnt 
you couLd attach 
RGB Lights straight 
onto the Pi. I made 
and coded these 
weather-controlled 
stairlights in under 
an hour. Each 
colour represents 
5 °C of the outside 
temperature." 

magpi.cc/cwenYY 


The GPIO expansion header 




The GPIOs, on or off 

The simplest way into your 

Pi are the 26 so-called GPIO ports, 

standing for ‘general-purpose input/ 
output’. These are on-off pms that you 
can either use as outputs or inputs, 
sending or receiving logic 1 or logic 
0 voltage levels. Use one anywhere 

a simple ON or OFF condition is 

required, for example to turn on or 0 
an LED, or to sense whether a button 
has been pressed. 


Life beyond the GPIO 

Sometimes you need more than 
is possible with a GPIO pin; the header 
has secondary functions that may 

help SPI,I 2 C, and l-wire are high 

speed interfaces for some peripheral 
chips that extend the capabilities 0 
the Pi. You might use them with an 
LCD display, a temperature sensor or 

an analogue-to-digital converter, e 

Sense HAT is an example of multiple 
chips at once connected m this way. 


it does 

Pi care 

All of those active GPIO pms 
lead directly into the CPU on your Pi, 
and thus if you apply too much voltage 
or current to them, you can damage 1 . 
They normally work at 33 V and 10 mA, 
so precautions, such as using a resistor 
with an LED, should be taken. To use 
your Pi with a 5 V device such as an 
Arduino, special HATs are available to 
protect your Pi and give you a buffered 
set of GPIOs to safely work with. 
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Alex Earnes 

“Start ‘small and 
simple' and you'LL 
be amazed at how 
quickly you can 
grow a project as 
you keep adding 
more and more bits 
to it and trying out 
and combining new 
ideas, learning and 
GoogLing as you go. 
You don't usually 
have to completely 
reinvent the wheel 
to implement 
your idea." 

raspi.tv 


The oscilloscope 

is optional, but: in 

front of it are the 

essentials of a wi 

hardware workbench 


T o connect your Pi to any external 

components, youHl need to pick up a 
few basic skills and have some tools. 

Don’t worry, though: there’s nothing difficult or 
expensive involved, and once you have them you’re 
all kitted out for further work. You’re at the start 
of the road to becoming an electronic engineer, 
and the techniques you’d use to wire something 
to a Pi are exactly the same as those used by the 
professionals, simply on a smaller scale. 


Start with your bench 

Your workspace, or your bench, is where 
you do your Pi experimenting and other electronic 
work. An ideal bench is well lit by a powerful 
lamp, and has a clear space surrounded by easy- 
to-reach racks for components and equipment, 
with plenty of power sockets. 

Organising your bench is important: there will 
be tiny screws and parts which can easily get lost. 
Soldering can damage surfaces with heat, and 
tools can mark surfaces when not used carefully. 
Look for a surface protector, ideally a silicone 
anti-static one intended for electronic use. Some 
form of small parts organiser is advisable. 
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Benchtop tools 

The standard toolkit starts at a surprisingly 
simple level with hand tools. A set of precision 
screwdrivers, a small pair of pliers, a wire stripper, 
a craft knife, and some Helping Hands are things 
you’ll find handy far beyond your work with the Pi. 

Anybody working with electronic hardware 
needs, at some point, to check for a voltage or a 
lack of it. A multimeter is the instrument for this 
task, and can be had for a surprisingly low cost. 

A typical inexpensive multimeter will feature a 
digital display and a rotary selector switch for its 
various voltage, current, and resistance ranges. 


Not just for your loaf 

At first, your circuits won’t be permanent 
- you’ll be exploring the many possibilities your Pi 
can offer. A breadboard is a convenient way to easily 
make circuits that are straightforward to dismantle 
or reconfigure. Available in a variety of sizes, a 
breadboard is a plastic block with a set of lines of 
spring contacts mounted under a grid of holes in 
its top. Circuits are made by inserting component 
leads through the holes, with connections via the 
lines of spring contacts underneath. 

A breadboard needs connections beyond its 
components, so you may also need a set of jumper 
leads. Get some that have socket-to-pin leads as 
well as just pin-to-pin: you can use the socket ends 
to connect to your Pi. 
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Making it all happen 

with GPIO Zero 


E Soldering for a 

permanent connection 

Breadboards are great for experimenting, but 
not for the long term. Soldering permanently 
joins conductors with molten metal for a good 
connection. It requires care, but will serve you well 
in any electronic work. 

The soldering iron is like a pencil whose tip 
reaches 350 °C to melt the solder. A soldering iron 
can deliver nasty burtns, so you should take care. 
Buy a stand with your iron, and some means of tip 
cleaning, such as a bundle of brass shavings or a 
wettable sponge. 

Cheap soldering irons will suffice, but buy a 
temperature-controlled one if you can afford it. 


"Make sure to Look at all 
the available interfaces 
the Pi has when using 
one in a hardware 
project. Often, the one 


To connect your Pi to any external 
components, you'll need to pick up a few 
basic skills and have some tools 


You don't have to make 
everything yourself 

It's important to note that some things are 
difficult to build, and there’s no shame in getting 
them from somebody else. If you need something 
3D-printed, for instance, your local hackspace may 
be able to help. A commercial motor controller 
HAT will be far more reliable than a home-made 
one, and an off-the-shelf robot frame will save 
you huge amounts of work. Many sensors and 
semiconductor parts are available in so-called 
breakout boards, in which the part is mounted on 
a small PCB whose connections are brought out to 
breadboard-friendly pins. 

It’s not cheating to buy something off-the- 
shelf, if it helps your project to work! 


"Remember that 
the community 
shares code 
examples widely 
- don’t be afraid 
to modify existing 
code, with credit to 
the original author 
of course!" 


Where to find all this stuff 

Most of what you need for an electronics^ 
workbench can be bought from the Raspberry 
Pi store in Cambridge (magpi.cc/retail-store). 
Elsewhere, there’s a huge range of online 
suppliers to ship you what you need. Take a 
look at the websites of the usual Raspberry Pi 
suppliers, ask for recommendations at your 
local Raspberry Jam, and watch out for stalls at 
Raspberry Pi events. Suppliers even offer them as 


tanyafish. 


kits of tools, or of soldering equipment. 
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Raspberry 

Pi laptop 


magpi.cc/bbGxDF 


FEATURE 


This Pi laptop looks good and 
was made with everyday tools 


There are many Pi laptop projects on the 
web, but a lot of them are made using 
expensive techniques such as laser cutting, 
which not all readers will have. We’ve therefore 
picked one made using common materials and 
everyday hand and power tools. Chitlange Sahas’s 
laptop is like many others in using a laptop screen 
with an HDMI converter board, and has two power 
banks to keep both display and Pi happy. A small 
USB keyboard completes the build, giving it a 
conventional clamshell form factor. 


"Even the Largest project can 
be broken down into small 
parts to work on. Watch out for 
feature creep, and be prepared 
to drop features to meet your target. 
It's not bad to fail: failing makes you a 
better maker when you Learn from 
your errors." 
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□ All the motor control 
electronics are taken 
care of by the servo 
manufacturer □ 


You will want your projects to have moving 
parts, and the humble servo provides an 
inexpensive and straightforward way to achieve 
this. The MeArm is a popular robotics project 
for which you can buy kits or try making from 
scratch. All the motor control electronics are 
taken care of by the servo manufacturer, so all you 
need to do is apply some power and PWM control 
from your Raspberry Pi. The exciting world of 
robotics awaits you! 


Servos give this robot arm life 


□ Pi: the MeArm 


magpi.cc/siviiT 


Driving NeoPixels 



with □ Raspberry Pi 


Pretty lights, a staple of so 
many maker projects 


magpi.cc/QXDsfQ 


The WS2812, sometimes called a NeoPixel, 
l _ j is an addressable and cascadable LED 
chip that can display any colour of the rainbow 
under software control. You will see them on 
a huge number of projects, and knowing how 
to drive them is a useful tool in any maker’s 
arsenal. Adafruit has a tutorial and some software 
to enable a Pi to drive NeoPixels, with a host of 
different hardware configuration options for 
diverse applications. WS2812S are available on a 
flexible tape, or in a variety of PCB configurations 
such as rings and sewable boards. 
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This Nintendo GameCube was 
destined for the dump, until a 
Pi rescued it 


RetroPie is a well-supported project 
that turns your Pi into a powerful 
multi-platform retro gaming machine. Liam 
McLoughlin had a Nintendo GameCube that 
no longer worked, so turned it into the perfect 
RetroPie console with the help of a Raspberry Pi, 
a Dremel, and copious quantities of hot glue. In 
a particularly neat touch, he was able to reuse 
the original GameCube power supply. People 
have built RetroPie machines in all sorts of 
incarnations, from handheld consoles with LCD 
screens, through retro consoles like this one, to 
full-size arcade cabinets with CRT monitors. 


Rachel 

‘Konichiwakitty’ Wong 


“Join the maker community 
on Twitter. It is easier to ask for 
help, especially if you are self- 


taught and don't know the correct 
terms, to take a photo of the problem and 
share it with hashtag #makershelp or tag any of 


reborn with □ Pi 


A retro console 


magpi.cc/tztAHx 


the customer services such as @Raspberry_Pi." 


magpi.cc/YxPqFw 
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A solar-powered 

weather station 


Track the weather with a Raspberry 


magpi.cc/xawnkY 


Brian Masney’s weather station takes a 
Pi Zero and turns it into a fully-featured 
weather station and data logger, with wind, 
rain, temperature, humidity, and pressure 
sensors. The Zero is mounted in a waterproof 
box along with a set of lithium-ion batteries, 
and topped with a solar panel. On winter days, 
there isn’t quite enough sun to keep it going all 
night, so he plans to fit a larger battery. His own 
YADL software completes the project, providing 
a browser interface with plenty of graphs to show 
the weather trends as they happen. 


A motion-tracking heater 


This Raspberry Pi heater will 
track your every move 


magpi.cc/uObdem 


The Raspberry Pi Camera Module can do so 
much more than capture snaps or videos. 

Matthias Wandel kept warm in his workshop by 
using his, along with motion detection software, 
to keep an infrared heater always pointing at 
him. The heater sits atop a rotating platform 
driven by a stepper motor from the Pi through 
a stepper controller board, and moves to point 
automatically at him. The software is his own 
Imgcomp package, though a similar result could 
be achieved with the popular OpenCV. ED 


A fully-featured weather 


station with wind, rain, 


temperature, humidity, and 


pressure sensors 
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Ben 

Nuttall 


Ben is the creator 
of GPIO Zero and 
piwheels, and is 
the Raspberry 
Pi Foundation's 
resident 
Python expert. 

@ben_nuttall 


You’ll Need 

> Raspberry Pi 
Zero or 3 A+ 

magpi.cc/wHwfNX 

> Raspberry Pi 
Camera Module 

magpi.cc/jbKzbf 

> Jam HAT, or buzzer 
and transistor 

magpi.cc/jMxZCU 

> Wilko Portable 
Standard Door 
Chime 

magpi.cc/pfUhqo 


► A £10 Wilko door-bell 
comes with a remote 
battery-powered 
chime unit 


Electronics 

with GPIO Zero 1.5 

Take an aff-the-shelf battery-powered door-bell and hack it to add new 
features, add a camera, and use a tonal buzzer to create your own jingle 


T he GPIO Zero library for Python now 

includes support for making tunes with 
buzzers, so it’s the perfect opportunity to 
hack yourself a new door-bell jingle. 


Upgrade GPIO Zero 

GPIO Zero vi.5 just came out! It’s got some 
new features we’re going to use in this tutorial, 
so make sure you upgrade! Check that your Pi’s 
online, open a Terminal, and type: 


sudo apt update 

sudo apt install python3-gpiozero 


Tonal buzzer 

One of the new device classes in GPIO Zero 
is TonalBuzzer, which allows you to play particular 
tones by setting the PWM frequency. You can play 
a sequence of notes to make a tune, or you can 
make interesting sound effects like a police siren 
by cycling through frequency ranges at different 
speeds. It’s nothing like the quality you’d get 
from a speaker, but it’s certainly possible to make 
discernible tones and jingles. There’s a tonal buzzer 
on ModMyPi’s new Jam HAT, or you can use a 
normal buzzer like the one in the Camjam kit, but 
you’ll get better results if you use a transistor to 
apply 5 V to the buzzer, like they do on the Jam HAT. 


That will bring in the latest GPIO Zero, and will 
install python3-colorzero too, as that’s a new 
dependency of GPIO Zero. 

You can check what version you have by typing: 

apt-cache policy python3-gpiozero 


Playing a tuna 

First of all, open up a Python shell or the 
REPL in your favourite Python editor and import 
the stuff you’ll need, then create a TonalBuzzer 
object on the GPIO pin it’s connected to: 


This will also tell you if there’s a new 
version available. 



from gpiozero import TonalBuzzer 
from gpiozero.tones import Tone 
from gpiozero.tools import sin_values 
from time import sleep 

tb = TonalBuzzer(20) 

Now try playing a single note: 

tb.play(60) 

That will play MIDI note 60 (middle C). You’ll get 
an ‘ambiguous tone’ warning, but don’t worry: 
that’s just because the Tone interface allows you to 
use MIDI notes, frequencies, or musical notation. 
To be more explicit, you would generally use 
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▲ Take a Look inside 


Tone(midi= 60 ) rather than just 60 or Tone( 60 ). Type 
tb.stopQ to stop it playing the note. TypeTone( 60 ) 
into the REPL to see its three representations: 

<Tone note='C4' midi=60 frequency=261.63Hz> 

Try playing a scale: 

for note in 'C4 D4 E4 F4 G4 A4 B4 C5'. 

splitQ: 

tone = Tone(note) 
print(repr(tone)) 
tb.play(tone) 
sleep(0.3) 
tb.stop() 



□ Create □ dictionary mapping each of the 
characters on the middle row of your 
keyboard to a note □ 


sudo pip3 install inputs 


Return to the Python shell, import get_key, and 
create a dictionary mapping each of the characters 
on the middle row of your keyboard to a note: 


▲ Connecting the 
door-beli wiring to 
the Pi's GPIO pins 


And finally, for effect, let’s try that siren noise we 
were telling you about: 

tb.source = sin_values() 

Simply passing in a series of values from the sine 
wave will make the buzzer continuously alter its 
frequency from one octave down to one octave up, 
achieving a siren effect. To speed it up or slow it 
down, alter the buzzer’s source_delay (default O.l): 

tb.source_delay = 0.01 

...or: 

tb.source_delay = 0.5 


Keyboard control 

Now install the inputs library, which is a 
great utility for reading (amongst other things) key 
presses in real-time. Open a Terminal and type: 


from inputs import get_key 


keys = {'A': 

’F': 'F4‘j 

'C4A 

'S' : 

'D4A 

' D' : 

'E4A 

'G' : 

'K': 'C5'} 

'G4A 

'H' : 

' A4' j 

'l' : 

1 B4 1 


Add a loop to look for these key presses and play 
notes when they’re pressed: 


while True: 

events = get_key() 
for event in events: 
if event.ev_type == 'Key' and 
event.code[-l] in 1 ASDFGH3K 1 : 

if event.state: 

tb.play(keys[event.code[-l]]) 

else: 

tb.stop() 

Now press any of the keys A to K and it’ll play a 
note. You’ve turned your computer keyboard into a 
musical keyboard! Try playing a tune. 


Top Tip A 


Programming 

paradigms 


Try out different 
programming 
styles - GPIO Zero 
provides different 
approaches 
including 
procedural, 
blocking, and 
callbacks. 

Read the 
documentation 
for a better 
understanding. 
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Top Tip 


Solder on 


Be cautious when 
soldering - you 
don’t want to 
accidentally 
desolder some 
other useful 
parts of the door¬ 
bell’s PCB. Take 
your time. 


Your own door-bell jingle 

We worked out the tune for the Pink 
Panther theme. Use this, or feel free to take this 
opportunity to create your own, using MIDI notes 
or musical notation. Or you could opt for the police 
siren effect, but that might be more alarming than 
necessary when it’s just an Amazon order delivery. 

For Pink Panther , here’s a function to take a list of 
notes and durations and play them in sequence. 
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def play(tune): 

for note, duration in tune: 
print(note) 
tb.play(note) 
sleep(float(duration)) 
tb.stop() 


tune = 

: [('C#4', 0. 

2).> (T 

(' 

.a 

LU 

, 0.2), 

(' E4' 

(' 

' F#4' 

, 0.2), 

( ' G4 1 

(' 

-O 

LU 

, 0.2), 

( ' E4‘ 

(' 

' F#4‘ 

, 0.2), 

( ' G4 1 

(' 

' C4', 

0.2), 

('B4', 

(' 

' F#4' 

, 0.2), 

( ' G4 1 

(' 

' B4 1 , 

0.2), 

('Bb4 1 

(' 

'A4', 

0.2), 

('G4', 

(' 

' D4', 

0.2), 

CE4', 


play(tune) 


>4', 0.2), (None, 0.2), 
, 0.2), (None, 0.6), 

, 0.2), (None, 0.6), 

, 0.2), (None, 0.2), 

, 0.2), (None, 0.2), 
0.2), (None, 0.2), 

, 0.2), (None, 0.2), 

, 0.5), (None, 0.6), 
0.2), ('E4', 0.2), 
0 . 2 )] 


Hacking the door-bell 

Note: These instructions are for battery- 
powered door-bells only. DO NOT use a mains- 
powered door-bell. 

Open up the door-bell chime by unscrewing the 
case to reveal the PCB inside. You’ll notice a white 
wire with one end unattached (that’s the radio 
receiver), red and black wires going to the battery 
pack, more white wires going to the speaker, and 
another pair of red and black wires going to the 
LED on the front of the case. When the door-bell is 
pressed and the signal is received, the LED comes 
on and the chime makes its sound. 

Optionally, you can choose to rewire the power 
to the receiver so that it comes from the Pi instead 
of batteries. Since it takes two AA batteries (1.5 V 
each), it requires ~3V. You can power it from the 
Pi by connecting the black wire to GND and the red 
wire to 3V3 (we soldered outs straight to a 3V3 pin 
hole on a Pi Zero). And of course, if you prefer your 
own jingle, you can disconnect the speaker. 

Next, desolder the wires going to the LED and 
connect them to the Pi instead: red to a GPIO pin, 
and black to GND (you can cut jumper wires in 
half and solder them to the wires, and connect the 
female end of the jumper wire to the Pi pins, or 
even solder the ends directly to the Pi Zero pin holes 
like we did). It’s best to test before you commit to 
soldering things together, so take it steady. 
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Comoro test 

The easiest way to initially test the camera 
is to open a Terminal and type: 


raspistill -k 


This opens the camera preview until you kill it with 
CTRL+C. Now back to Python; write some simple 
code to trigger capturing a photo in a loop: 


from picamera import PiCamera 
from datetime import datetime 

camera = PiCamera() 

while True: 

input("Press Enter to capture") 
dt = datetime.now().isoformat() 
camera.capture(Yhome/pi/{}.jpg'.format(dt)) 

This will take a picture when ENTER is pressed, 
and save it with the current timestamp. 


Testing the door-bell 

Did it work? Let’s see. In theory, you should 
be able to detect a signal on the GPIO pin you wired 
the door-bell to, the same way you’d detect a button 
being pressed. So, back to Python and GPIO Zero: 
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from gpiozero import Button 

doorbell = Button(21) 

button.wait_for_press() 
print("Pressed") 
button.wait_for_release() 
print("Released") 


Now press the door-bell, and you should see the 
message ‘pressed’ when the door-bell is pressed, 
and ‘released’ once the chime stops playing. If it 
doesn’t seem to be working, you’ll need to check 
your wiring. You might need to add a resistor to 
make sure you detect the change in voltage when 
the button is pressed. We found that if we wired 
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▲ Connecting the door-beLL wiring to the Pi's GPIO pins 


ours directly to the IC (red square on the picture), 
the resistor in between would take effect. 


Putting it all together 

Now let’s put together all the components: 
the door-bell, the jingle, and the camera. If you 
want to dedicate a Pi to live in this project, it 
should probably be a Pi Zero W or 3A+. With a Pi 
Zero, you can solder the components directly to 
the GPIO pin holes. You’ll have easier access to 
the GPIO pins with the 3A+ or another full(er)- 
size Pi, but it will take up more space, which may 
be at a premium if you’re trying to fit it all inside a 
small container (especially the original door-bell 
receiver enclosure). 

Connect your Jam HAT or your buzzer, and 
solder your door-bell receiver wires and connect 
them to the Pi’s GPIO pins. Connect the camera 
and find a way to mount it in place. If you’ve got 
clear glass on your front door, you can stick the 
Pi behind or beside the door and have the camera 
facing out. Make sure all your connections are 
strong, and the enclosure is keeping everything in 
place, then connect the Pi’s power supply, making 
sure it won’t get pulled out. Attach the door-bell 
to the front door, and put your code together to 
give it a whirl! See the completed code in the 
doorbell.py listing. 


doorbell.py 

> Language: Python 3 


DOWNLOAD 
THE FULL CODE: 


^ magpi.cc/github 81 


001. 

from gpiozeno import TonalBuzzer 

', Button 

002. 

from picamera import PiCamera 


003. 

004. 

from datetime import datetime 


005. 

buzzer = TonalBuzzer(20) 


006. 

doorbell = Button(21) 


007. 

008. 

camera = PiCameraQ 


009. 

def play(tune): 


010. 

for note, duration in tune: 


011. 

buzzer. play(note) 


012. 

sleep(float(duration) ) 


013. 

014. 

buzzer. stop() 


015. 

pink_panther = [ 


016. 

('CM 1 , 0.2), ( 'D4' , 0.2), 

(None, 0.2), 

017. 

( 'Eb4' , 0.2), ( 'E4' , 0.2), 

(None, 0.6), 

018. 

( 'F#4' , 0.2), ( 'G4' , 0.2), 

(None, 0.6), 

019. 

( 'Eb4' , 0.2), ( 'E4' , 0.2), 

(None, 0.2), 

020. 

( 'F#4' , 0.2), ( 'G4' , 0.2), 

(None, 0.2), 

021. 

( 'C4' , 0.2), ( 'B4' , 0.2), 

(None, 0.2), 

022. 

( 'F#4' , 0.2), ( 'G4' , 0.2), 

(None, 0.2), 

023. 

( 'B4' , 0.2), ( 'Bb4' , 0.5), 

(None, 0.6), 

024. 

( 'A4' , 0.2), ( 'G4' , 0.2), 

CE4’, 0.2), 

025. 

( 'D4' , 0.2), ( 'E4' , 0.2) 


026. 

027. 

] 


028. 

while True: 


029. 

doorbell. wait_for_press () 


030. 

dt = datetime. now() .isoformat () 

031. 

camera. capture( '/home/pi/{}. 

jpg’ .format(dt)) 

032. 

play(pink_panther) 



Just add a new recurrent task that launches at 
reboot. The task should look something like this: 


python3 /home/pi/doorbell.py & 


Run at boot 

The important finishing touch is to have 
your program run at boot. There are a good few 
ways of doing this, and if you want to find out some 
alternatives, just ask someone how they tend to 
do it - chances are you’ll get a different response 
each time. Your author’s preference for basic script 
launching like this is cron, either using crontab 
if you know how, or we’d recommend installing 
GNOME Schedule, a cron GUI: 


sudo apt install gnome-schedule 


Make it your own 

So far we’ve added some basic features - a 
custom jingle and camera - but there’s much more 
you could do. If you have smart light-bulbs, you 
could have it flash the house lights to give a visual 
indication when the door-bell rings, even when 
you have music playing. You could have it email, 
text, or tweet you. How about a push notification to 
your phone? If you’re feeling ambitious, you could 
try to identify the door knocker and decide who to 
let in! The world is your door-bell. E3 
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Hattersley 
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gaming, building 
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magpi.cc 


You'll Need 


> Raspberry Pi 
2/3B/3B+ 

> USB keyboard 
(for setup) 

> Blank microSD card 

magpi.cc/ 

noobscard 

> SD Memory Card 
Formatter 

magpi.cc/ 

sdcardformatter 

> RetroPie image file 

retropie.org.uk/ 

download 

> Blade Buster ROM 

magpi.cc/ 

bladebuster 


Discover clossic gaming on the Raspberry Pi and play 
homebrew ROMs. By Lucy Hattersley 


T urning a Raspberry Pi device into a retro 

games console is a fun project, and it’s one 
of the first things many a new Pi owner 
turns their hand to. 

The appeal is obvious. Retro games are fun, 
and from a programming perspective they’re 
a lot easier to understand than modern 3D 
powerhouses. The Raspberry Pi board’s small 
form factor, low power usage, HDMI connection, 
and wireless networking make it a perfect micro¬ 
console that can sit under your television. 

There are a bunch of different emulators around 
for Raspberry Pi. In this tutorial we’re going to 
look at RetroPie. 

RetroPie combines Raspbian, EmulationStation 
(emulationstation.org), and RetroArch 
(retroarch.com) into one handy image. With 
RetroPie you can emulate arcade games, as well as 
titles originally released on a host of 8-bit, 16-bit, 
and even 32- and 64-bit systems. You can hook 
up a joypad; we’re going to use the Wireless USB 
Game Controller (magpi.cc/bbOgnE), but most 
other USB game controllers will work. 



▲ Configuring the gamepad maps its controls to the RetroPie 
games system so you can controLthe video game 


You can also use Bluetooth to connect a controller 
from most video games consoles. RetroPie has an 
interface that will be very familiar to anyone who 
has used a modern games console and, because it is 
open-source, it is constantly being improved. 

You can look online for classic games, but we 
prefer homebrew and modern releases coded 
for classic systems. In this tutorial we will walk 
you through the process of setting up RetroPie, 
configuring a gamepad, and running a homebrew 
game called Blade Buster. 


Get your microSD card ready 

RetroPie is built on top of Raspbian (the 
operating system for Raspberry Pi). While it is 
possible to install RetroPie from the desktop 
interface, it’s far easier to format a microSD 
card and copy a new RetroPie image to the blank 
card. This ensures all the settings are correct 
and makes setup much easier. Our favourite 
method of wiping microSD cards on a PC or 
Apple Mac is to use SD Memory Card Formatter 
(magpi.cc/sdcardformatter). 

Attach the microSD card to your Windows 
or Mac computer and open SD Card Formatter. 
Ensure the card is highlighted in the ‘Select card’ 
section, then click Format. 


Download RetroPie 

Download the RetroPie image from 

retropie.org.uk/download. It’ll be downloaded as 
a gzip file; the best way to expand this on Windows 
is using 7-Zip (7-zip.org). With 7-Zip installed, 
right-click the retropie-4.4-rpi2_rpi3.img.gz file 
and choose 7-Zip > Extract here. Extract GZ files on 
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We’re using a wireless USB controller 
designed for retro gaming on the 
Raspberry Pi. You can also use controllers 
for modern video games consoles 


The heart of our games 
console is a Raspberry 
Pi 3B+. With a fast CPU 
and plenty of RAM, our 
retro game plays fluidly 


a Mac or Linux PC using gunzip -k <filename.gz> 
(the -k option keeps the original GZ file). 

gunzip -k retropie-4.4-rpi2_rpi3.img.gz 


Flash the image 

We’re going to use Etcher to copy the 

retropie-4.4-rpi2_rpi3.img file to our freshly 
formatted microSD card. 

Download Etcher from balena.io/etcher. 

Open Etcher and click Select Image, then choose 

the retropie-4.4-rpi2_rpi3.img image file and 
click Open. 

Etcher should have already located the microSD 
card; remove and replace it if you see a Select Drive 
button. Click 'Flash!' to copy the RetroPie image to 
the microSD card. 

See magpi.cc/etcher for more information on 
how to use Etcher to flash SD cards. 


Set up the Raspberry Pi 

Insert the flashed microSD card to your 
Raspberry Pi. Now attach the Raspberry Pi to a 
TV or monitor using the HDMI cable. Connect 
the USB dongle from the Wireless USB Game 
Controller (magpi.cc/gamepad) to the Raspberry 
Pi. Also attach a keyboard (you’ll need this for the 
setup process). 


□ RetroPie has an interface that will be 
very familiar to anyone who has used a 
modern games console □ 

Insert the batteries in the Wireless USB Game 
Controller and set the power switch (on the 
back of the device) to 'On’. Once everything 
is connected, attach a power supply to the 
Raspberry Pi. 

See magpi.cc/quickstart for more detailed 
information on setting up a Raspberry Pi. 


Configure the gamepad 

When RetroPie starts, you should 
see Welcome screen displaying the message 
'1 gamepad detected’. Press and hold one of 
the buttons on the pad and you will see the 
Configuring screen with a list of gamepad buttons 
and directions. 

Tap the D-pad (the four-way directional control 
pad on the far left) up on the controller and 'HAT 0 
UP’ will appear. Now tap the D-pad down. 

Map the A, B, X, Y buttons to: 


A: red circle 
B: blue cross 
X: green triangle 
Y: purple square 


Top Tip 

4 

Username and 

password 



If RetroPie asks 
you for the 
username and 
password during 
boot, the defaults 
are: pi and 
raspberry. 
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TopTip 

4 

Fix the borders 



These are caused by overscan. Choose RetroPie 


from EmulationStation and raspi-config. Now select 
Advanced Options > Overscan and select No on the 
'Would you like to enable compensation for displays 
with overscan?’ window. Choose OK and then Finish. 
Choose Yes on the Reboot Now window. When the 
system reboots, you will see the borders removed. 


wireless LAN network so you can access it when it’s 
beneath your television. 

Head back into RetroPie from EmulationStation 
and down to the WiFi setting; choose ‘Connect to 
WiFi network’. 

The window will display a list of nearby wireless 
LAN networks. Choose your network and use the 
keyboard to enter the wireless LAN password. Press 
ENTER when you’re done. Choose the Exit option 
to return to the RetroPie interface. 


The Left and Right Shoulder buttons refer to the 
topmost buttons on the rear of the controller, 
while the Triggers are the larger lower buttons. 
Push the left and right analogue sticks in for the 
Left and Right Thumbs. Click OK when you’re done. 


Choose the network locale 

RetroPie boots into EmulationStation, 
which is your starter interface. It’s currently 
displaying just the one option, RetroPie, which is 
used to set up the emulation options. As you add 
games to RetroPie, other systems will appear 
in EmulationStation. 

With RetroPie selected, press the A button on 
the gamepad to open the configuration window. 
Use the D-pad to move down the options and 
select ‘WiFi’. You will see a warning message: 
‘You don’t currently have your WiFi country 
set...’. Press the D-pad left to choose Yes and 
press A. 

The interface will open raspi-config. At this 
point, we find it handy to switch to the keyboard 
and use that instead. 

Choose ‘4 Localisation Options’, and press 
the right arrow key on the keyboard to highlight 
Select, then press ENTER. 

Now choose ‘4 Change Wi-fi Country’ and pick 
your country from the list. We used GB Britain 
(UK). Highlight ‘Ok’ and press ENTER to select it. 

Now move right twice to choose Finish and 
press ENTER. This will reboot the system. 


Connect to wireless LAN 

If you have a Raspberry Pi with an Ethernet 
connection, you can use an Ethernet cable to 
connect directly to your router/modem or network. 
More likely, you’ll connect the Raspberry Pi to a 


Configuration tools 

Now choose RetroPie Setup and then 
Configuration Tools. Here, in the ‘Choose an option’ 
window, you’ll find a range of useful tools. As we’re 
using a USB gamepad, we don’t need the Bluetooth 
settings, but it’s worth noting they’re here. 

We want to turn on Samba so we can share files 
from our computer directly to RetroPie. Choose 
Samba and ‘Install RetroPie Samba shares’, then 
select OK. 

Now choose Cancel to back up to the ‘Choose 
an option’ window, and then Back to return to the 
RetroPie-Setup script. 


Run the setup script 

Choose ‘Update RetroPie-Setup script’ and 
press ENTER. After the script has updated, press 
ENTER again and you’ll be back at the ‘Notice:’ 
window. Press ENTER and choose ‘Basic install’; 
press ENTER, choose Yes, and press ENTER again 
to begin the setup and run the configuration script. 

When the script has finished, choose ‘Perform a 
reboot’ and Yes. 
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V Update the 
RetroPie-Setup 
script and configure 
it to activate 
Samba before 
running through 
the installation 
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► BLade Buster is a 
homebrew video 
game designed for 
NES systems. Here 
it is running on a 
Raspberry Pi 


Top Tip 


Change the 
resolution 


Some games 
were designed 
for a much Lower 
resolution, and 
scaling them up 
can look blocky 
on modern 
televisions. If you'd 
prefer to alter the 
resolution, choose 
'RetroPie setup*. 
Open raspi-config, 
Advanced Options, 
and Resolution. 
Here you’ll find 
a range of other 
resolution options 
to choose from. 



Turn on Samba in Windows 

We’re going to use Samba to copy a ROM 
file (a video game image) from our computer 
to RetroPie. 

Samba used to be installed by default in 
Windows, but it has recently become an optional 
installation. In Windows 10, click on the Search bar 
and type ‘Control Panel’. Click on Control Panel in 
the search results. Now click ‘Programs’ and ‘Turn 
Windows features on or off’. Scroll down to find 
‘SMB l.o/CIFS File Sharing Support’ and click the 
‘+’ expand icon to reveal its options. Place a check 
in the box marked ‘SMB l.o/CIFS Client’. Click 
OK. This will enable Samba client support on your 
Windows 10 PC so it can access the Raspberry Pi. 

See magpi.cc/samba for more information on 
how Samba works. 


Get the game 

On your Windows PC or Mac, open a web 
browser, and visit magpi.cc/bladebuster. This is 
a homebrew video game designed by High Level 
Challenge for old NES systems. The developer’s 
website is in Japanese, but click ‘BLADE 
BUSTER Download’ to save the ROM file to your 
Downloads folder. 

Open a File Explorer (or Finder) window 
and locate the BB_20120301.zip file in your 
Downloads folder. Don’t unzip the file. Click on 
Network and you’ll see a RETROPIE share. Open 
it and locate the roms folder. Double-click roms 
and you’ll see folders for many classic systems. 
Drag and drop the BB_20120301.zip file and place 
it inside the nes folder. 


Top Tip 

4 

Install Raspbian desktop 



RetroPie is built on top of the Raspbian operating 
system. You might be tempted to install RetroPie on 
top of the Raspbian with Desktop interface, but it’s 
actually much easier to do it the other way around. 
Open RetroPie from EmulationStation and choose 
'RetroPie setup 1 . Select ’Configuration tools’ and 
'Raspbian tools’. Then choose 'Install Pixel desktop 
environment’ and Yes. 

When it’s finished, choose Quit and Restart 
EmulationStation. When restarted, EmulationStation 
will display a Ports option. Select it and choose 
Desktop to boot into the Raspbian desktop interface. 


Play the game 

Press the Start button on your gamepad 
to bring up the Main Menu. Choose Quit and 
Restart EmulationStation. You’ll now see a 
Nintendo Entertainment System option with 
‘1 Games Available’ below it. Click it and you’ll see 
BB_20i2030i - this is Blade Buster. Press A to start 
the game. Have fun shooting aliens. Press Start 
and Analog (or whatever you’ve set as your hotkey) 
together when you’re finished; this will take you 
back to the game selection in EmulationStation. 

If you’ve been setting up RetroPie on your 
monitor, now is the time to move it across to your 
main television. The RetroPie console will boot 
automatically, connect to the network, and you can 
move ROM files over to it from your PC or Mac. You 
may notice at this point black borders around the 
screen; if so, see the ‘Fix the borders’ tip. 

Enjoy your gaming system! E 1 


42 | magpi.cc | Make a retro console with RetroPie 























c|nfl . R ASP8ERRV PI MAGAZINE 

your official rasp - ■ - - - 


keyboards 

jBaflWfllGFlD HIFIB 


jfficialBasP 


April 20W 


issue » 


3 ISSUES 

FROM £5 


0 Email: magpi@subscriptionhelpline.co.uk 




MAKER 


McufPi I TUTORIAL 


Raspberry Pi 

Party popper launcher 


Need to fire a party popper and want to use code to pull the cord? What you need 
is an automated Raspberry Pi-powered Party Popper Launcher 



Mark 

Vanstone 


Educational 
software author 
from the nineties, 
author of the 
ArcVenture series, 
disappeared into 
the corporate 
software wasteland. 
Rescued by the 
Raspberry Pi! 

magpi.cc/YiZnxL 

@mindexplorers 


T he Party Popper idea was first presented 
as a fireworks day workshop at the Milton 
Keynes Raspberry Jam, and then expanded 
for The Girls Day at Bletchley Park National 
Museum of Computing, covered in TheMagPi #77 
(magpi.cc/77). The contraption enables us to 
remotely trigger a party popper (or poppers) with 
some simple Python code on our Raspberry Pi. 

We will first need to create a holder for our party 
popper, which we can design in a 3D modelling app 
and make with a 3D printer. Then, we will be firing 
it using the action of a low-cost servo. 


Let's start from the end 

Normally when introducing a tutorial, we 
would start with the basics and build up the idea, 
but in this case we need to see what we are aiming 
at, and then go back and put together each part 
of the build. This is how we approached designing 


the launcher: we decided what needed to happen 
and then worked on each part until it satisfied 
the requirement. So here is our impression of 
monkeys writing War and Peace , but we’ll miss 
out the bits that didn’t work. See the main image 
for the fully assembled launcher, and we’ll go 
through the parts that it’s made of. 


The holding device 

The launcher was designed using Blender 
and then 3D-printed. The source files are all 
available on GitHub (magpi.cc/YiZQxd) if you want 
to play with the design. First, let’s look at a way 
of holding a party popper; it will need to be held 
straight with access to the firing string. We have a 
tube shape, with the inside being a width to mimic 
the popper shape, and a hole for the ‘handle’ to 
go though. The base of the tube is quite thick, to 
enable a post to be attached and be a firm fit. 


You'll Need 


> Party poppers 

> 3 D modelling app 

blender.org 

> A 3 D printer 

magpi.cc/69 

> A heavy-duty 
digital servo 

magpi.cc/cVxSzg 

> 3 x male-to-female 
jumper leads 

magpi.cc/gqdtDy 



▼ If at first you don’t succeed, keep 
printing! When developing a project 
from scratch, expect to have a few 
Leftovers. This is a smalLsampLe 
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Party popper 
Launcher printed 
with PLA filament. 
The Launcher is 
printed in four parts: 
two for the base, one 
for the holder, and a 
post to join them 


The servo connects directly to the GPIO pins on the Raspberry 
Pi. One connects to ground, one to a 5 V pin, and the signal lead 
connects to one of the pins that can be set for PWM 
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The base 

The base could be printed out in one piece, 
but we found that laying the main part on its side 
made for a better construction for the servo to be 
mounted into. An interlocking cross-piece can 
then be printed to provide some stability to the 
base and stop it from falling over. When printing 
these pieces, you may need to adjust the wall 
widths so that they fit snugly together, but are 
not too tight. The base also has a hole, as with the 
holder part, so that a post can be attached. 


The post 

This is where it all comes together. The post 
is just a cylinder to attach the holder to the base. 

It does have a flat edge along its length, but that 
is only so that it sticks well to the 3D printer bed 
while it is printing. With this design, all four parts 
can be printed in a single print and then packed 
up into a small box, such as a plastic business 
card holder, with the other components for the 
build, which makes it ideal for workshops. It also 
provides an extra dimension of making for the 
workshop if no assembly instructions are provided. 


3 D print designing 

So, we have covered what the 3D-printed 
parts are, but not how they were made. If you have 
not designed your own 3D parts before, it’s not 
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difficult. You need a 3D modelling app; there are 
several free and paid-for options. Our favourite 
at the moment is Blender, because it’s free and 
we have followed its development for years; the 
makers have just made the beta of 2.8 available, 
and it rocks! Any modelling app that exports .obj 
or.3ds files or similar will be fine, as long as that is 
compatible with your 3D-printing software. 


Making the shapes 

If you are new to 3D modelling, try to keep 
the objects you make fairly simple to start with. 
This build is a good example of just using basic 
shapes. We have a few rectangles, a long cylinder, 
and short, wide cylinder. The way to make the 


Top Tip 4 


Blender 


3 D modelling on 
the Raspberry Pi 
is a bit limited due 
to the hardware 
graphics support. 
You can install 
Blender with 
sudo apt-get 
install 
blender. There 
are also a few 
other options, 
such as 3 D Slash. 



A 3D parts can be 
designed and 
redesigned in a 3D 
modelling app and 
then exported to 3D 
printing software. 

The printer then uses 
filament to build up 
the parts in layers 
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Top Tip 


Analogue 

servos 


You can use 
analogue servos 
for this, but 
because the GPIO 
is digital, you may 
find that working 
out the angles 
is more difficult, 
as the output 
will give some 
weird results. 


various holes in these shapes is to create a solid 
shape, then make a shape that you want to cut 
out. Then you can use a Boolean tool to subtract 
or cut out the second shape from the first. When 
you have completed your design, export the model 
in a suitable format. Try a few different ones, as 
the results may vary when you import into your 
3D printing software. 


3D printing 

Due to the way the parts are laid out, there 
are no significant overhangs, other than the small 
post holes, which means you shouldn’t need to 
clear away any supports or extra stuff. We used PLA 
filament on a very cheap, self-assembled printer. 
As a side note, if you want to find out all about 
how 3D printers work, get a DIY version and if you 
are feeling brave, a really cheap one with foreign 
instructions. By the end of the process of getting it 
working, you will know all about every component! 


▼ Because the 
3D printer builds 
upwards, it’s best 
to design parts so 
that there is no 
overhang to fill in, 
otherwise the print 
can get messy 


Heavy-duty servos 

To start with, the obvious thing was to reach 
into the drawer and pull out whatever gizmos could 
be found that might be able to pull a party popper 
string. We tried a motor, but there were issues 
around needing gears, a suitable driver module, 
and mounting it securely. We then found one of 
the little blue 9 g servos. It tried, it really did, but 
in the end we had to accept that it was not going 
to do the job. We found a lone HS-422 servo in the 
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▲ Figure l The jumper leads connect red to 5V, yellow/ 
orange to GPIO2 and brown/black to GND 


drawer, reworked the stand, and found a better 
result. Since then, we have found MG 996RS are 
very similar in size and effect for this application. 


Plugging it in 

It is possible to wire the servo directly to 
the Raspberry Pi GPIO pins with three male-to- 
female jumper leads. Take a look at Figure 1 for 
where the wires go. A word of warning: although 
plugging in these electronics into these pins with 
the Pi running shouldn’t cause it damage, if you 
get it wrong, the outcome could be very different, 
so always power down the Pi before wiring up 
the GPIO pins, and check they are correct before 
switching back on. Once everything is hooked up, 
we can test the servo and get it moving. 


Testing 1, 2,3 

We can write a simple Python program to 
make the servo turn. See party_popper.py for 
the listing. We can write it using IDLE 3 or, if you 
prefer, another editor provided with Raspbian. 

We set up GPIO 2 (which is physical pin 3) to PWM 
(pulse-width modulation) mode and start the 
output. We then have a function to change the 



▲ The setAngle() function will move the servo armature 
from its existing position to the new angle 
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angle of the servo arm. We calculate the pwm value 
we need from the angle and change the duty cycle 
of the servo, wait for it to move, and then reset 
that value. By changing the value in the setAngle() 
call below this function, we will see the servo arm 
moving when we run the program. 


□ In □ couple of seconds the servo should 
spring into life, pulling down on the 
string with several kilograms of force 3 


Using the angles 

It will depend how the armature of the servo 
is set, and probably a few other factors, that will 
define what angles are needed for the servo to move 
and pull the popper string far enough to set it off. If 
you mount the servo in the base so that the string 
can be attached to the end of the armature and 
as it turns, it pulls the string straight down (or as 
straight as possible), then you just need to find the 
angle at which the length of the string is shortest, 
and then the angle at the armature’s lowest. 


Fire in the hole! 

If everything is wired up correctly, your 
servo is set to the starting position and slotted 
into the base of the holder, the string is attached 
tightly to the armature, then we are ready to fire 
our party popper. Run the code with the setAngle() 
parameter set to the end angle we need, and in a 
couple of seconds the servo should spring into life, 
pulling down on the string with several kilograms 
of force. Before you know it, there should be a loud 
pop and a nice pile of streamers to clear up! EH 


party_popper.py 

> Language: Python 


DOWNLOAD 
THE FULL CODE: 


© magpi.cc/YiZQxd 


001. import RPi.GPIO as GPIO 
002. from time import sleep 
003. 

004. GPIO. setmode (GPIO.BOARD) 

005. GPIO. setup(3, GPIO.OUT) 

006. pwm=GPIO. PWM(3, 50) 

007. pwm. start (0) 

008. 

009. def setAngle(angle): 

010. duty=angle/18+2 

011. GPIO. output (3, True) 

012. pwm.ChangeDutyCycle(duty) 

013. sleep(l) 

014. GPIO. output (3, False) 

015. pwm.ChangeDutyCycle(0) 

016. 

017. setAngle(0) 

018. 

019. pwm. stop () 

020. GPIO.cleanupQ 



Top Tip 


Workshop 

notes 


You can find the 
original workshop 
notes on the 
TechnoVisual 
Education site at: 
magpi.cc/yKUSQg 


M The party popper 
holder is a cylinder 
with a hole through 
the bottom and, on 
the underside, has a 
post hole to attach it 
to the base 
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PJ 

Evans 


PJ is a writer, 
deveLoper, and 
MiLton Keynes 
Jam wrangler. He 
has terrible taste 
in movies. 

mrpjevans.com 


You'll Need 


> Pi Camera Module 

magpi.cc/camera 

> A houseplant 

> Ruler or similar 
rectangular object 

> Contrasting, plain 
backdrop 


Use AI to build 

a plant monitor 

Measure the height and width of objects with your 
Raspberry Pi using only the Pi Camera Module and OpenCV 


D o you know how tall your plant is? Do you 

wonder how high it is growing? Does using 
a ruler just sound like effort? Well, we have 
the tutorial for you. We’re going to measure a 
plant just using images taken with a Pi Camera 
Module. In the process, we’ll introduce you to 
OpenCV, a powerful tool for image analysis and 
object recognition. By comparing your plant to a 
static object, OpenCV can be used to estimate its 
current height, all without touching. By adding 
data from other sensors, such as temperature or 
humidity, you too can build a smart plant. 


Pick a spot 

We’re going to be using OpenCV (version 2) 
to measure our plant. To make sure our 
measurement is as accurate as possible, several 


factors need to be considered. The background 
must be plain and contrast against the plant; 
black or white is ideal. The area you are using 
must be very well lit when the image is taken. 
Finally, the camera must be 90 degrees to the 
plant, facing it directly. Any angles on any axis 
will cause poor measurement. If you are mounting 
the camera at a significant distance, you may want 
to consider a telephoto lens. 


Get a plant and object 

So how do we pull off this measuring 
trick? We can estimate the height of an object by 
comparing it with another object that is a fixed 
and known width and height. The image taken 
by the camera needs to include both objects. Get 
a rectangular object of a comparable size to your 
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▲ Our testing rig. Note the camera is as cLose to go degrees 
to the plant as we couLd manage 


plant; we used a long piece of Lego. A metal ruler 
would also work well. Mount your object in front of 
the camera so it is on the left of the image and the 
same distance from the camera as your plant. 


Prepare your Pi 

The software used to analyse the image 
is the powerful OpenCV library and its Python 
bindings. You can use any current Pi for this 
project, but the higher-end 3B/3B+ will be much 
quicker at processing the image. OpenCV requires 
an X Window system in place, so we need to start 
with Raspbian Stretch including the Raspberry Pi 
Desktop. Once ready to go and on the network, 
make sure everything is up-to-date by running: 


sudo apt update && sudo apt -y upgrade 

Finally, install the camera, if you haven’t already, 
and enable it in Preferences > Raspberry Pi 
Configuration > Interfaces, then reboot. 


Install dependencies 

OpenCV is a bit trickier to install than most 
packages. It has lots of dependencies (additional 
software it ‘depends* on) that are not installed 
alongside it. We also need a few other things to 
get OpenCV talking to the camera, so open up a 
Terminal window and run the following commands: 


sudo apt install python3-pip libatlas-base- 
dev libhdf5-100 libjasperl libqtcore4 libqt4- 
test libqtgui4 


pip3 install imutils opencv-contrib-python 
picamera[array] 


plantbot.py 

> Language: Python 3 


DOWNLOAD 
THE FULL CODE: 


© magpi.cc/omacNA 


001. import argparse 

002. import imutils.contours 

003. import cv2 

004. from picamera.array import PiRGBArray 
005. from picamera import PiCamera 
006. from time import sleep 
007. 

008. # Get our options 

009. parser = argparse.ArgumentParser(description=' Object 
height measurement') 

010. parser.add_argument("-w", "--width", type=float, 
required=True, 

011. help= 

"width of the left-most object in the image ) 

012. args = vars(parser.parse_args()) 

013. 

014. # Take a photo 

015. camera = PiCameraQ 

016. rawCapture = PiRGBArray(camera) 

017. sleep(0. 1) 

018. camera. capture(rawCapture, format="bgr" ) 

019. image = rawCapture.array 

020 . 

021. # Cover to grayscale and blur 

022. greyscale = cv2. cvtColor (image, cv2.C0L0R_BGR2GRAY) 

023. greyscale = cv2.GaussianBlur (greyscale, (7, 7), 0) 

024. 

025. # Detect edges and close gaps 

026. canny_output = cv2.Canny(greyscale, 50, 100) 

027. canny_output = cv2. dilate(canny_output. None, 
iterations=l) 

028. canny_output = cv2.erode(canny_output. None, iterations=l) 
029. 

030. # Get the contours of the shapes, sort 1-to-r and create 

boxes 

031. _, contours, _ = cv2.findContours(canny_output, cv2.RETR_ 

EXTERNAL, 

032. cv2.CHAIN_APPROX_SIMPLE) 

033. if len(contours) < 2: 

034. print("Couldn 't detect two or more objects") 

035. exit(0) 

036. 

037. (contours, _) = imutils.contours. sort_contours(contours) 
038. contours_poly = [None] *len(contours) 
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Top Tip 


Location, 

location, 

location 


Make sure you 
avoid your 1970s 
flock wallpaper. 
You need a well-lit 
plain background 
for this to work. 


T This overlay shows 
how OpenCV has 
mapped the test 
image. It can be far 
more accurate, but 
this faster method 
meets our needs 



Mfiii v.drm *r BTWi iww R'T'in 


Although piwheels speeds things up considerably, 
you can expect the second command to take a 
little while to run, so now’s a good time to get a 
cup of tea. 


Calibration test 

Before we start running code, make sure 
everything is lined up as you would like it. The 
easiest way to do this is to open a Terminal prompt 
on the Desktop and run the following command: 


raspistill -t 0 


This puts the camera in ‘preview’ mode (you’ll 
need to be directly connected to see this - it won’t 
work over VNC without extra configuration). Study 
the image carefully. Is the camera at an angle? Is it 
too high or low? Is there enough contrast between 
your object, plant, and background? How’s the 
light? Press CTRL+C when you’re finished. 


Coding time 

Enter the code from the plantbot.py listing 
in your editor of choice and save it. If you don’t 
fancy typing, you can download the code and some 
sample images from magpi.cc/akmZsW. The code 
takes an image from the Pi Camera as a stream 
and sends it to OpenCV. The image is then placed 
through some cleaning filters and the shapes 
detected. We know the nearest shape to the 0,0 
‘origin’ (the top-left of the image) will be our 
calibration object. So long as we know the width of 
that object, we can estimate the size of others. 



Run the code 

Let’s take our first image. Carefully 
measure the width of your calibration object. 
Ours was 16 mm. To run the code, enter the 
following command in the same location as your 

plantbot.py file: 


python3 plantbot.py -w 16 


Replace the ‘16’ with the width of your calibration 
object. After a few seconds, you’ll see the image 
with, hopefully, a light blue rectangle around the 
leftmost object and one or more boxes around the 
plant. As the plant is an irregular object, OpenCV 
will find lots of ‘bounding boxes.’ The code takes 
the highest and lowest to calculate the height. 


Big plant data 

Once you’ve had fun measuring all the 
things, you can alter the code to write the results to 
a file. Add the following to the ‘import’ section at 
the start of the code: 


import datetime 


Now remove the final six lines (the first one starts 
‘print’) and replace with: 


print("\"" + str(datetime.datetime.now()) + 
\V + str(plantHeight)) 


This version can be employed to create a CSV file of 
measurements that maybe used to create graphs 
so you can track your plant’s growth. 


Keep on schedule 

Let’s say you wanted to take a measurement 
every day. You can do this by using Raspbian’s cron 
system. Cron is an easy way to run scripts on a 
regular basis. To access the main cron file (known 
as a crontab), run the following: 


sudo nano /etc/crontab 


At the bottom of the file, add this line: 


0 14 * * * pi python3 /home/ 

pi/plantbot/plantbot.py -w 16 >> /home/pi/ 
plantbot.csv 
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▲ An example of what OpenCV sees, with the calibration 
object on the left, and some daffodils on the right 


□ You can measure anything you want with 
this project, even growing youngsters, but 
why stop there? □ 


This tells cron to run our script every day at 2 pm 
(that’s the ( o 14’ bit) and append its output to 
plantbot.csv, which can be read by any popular 
spreadsheet app. 


Got water? 

Now you’re collecting data on your beloved 
plant’s height, why not add other data too? 

A common Raspberry Pi project is to use soil 
moisture sensors. These are inexpensive and 
widely available (magpi.cc/seyhTc). See if you 
can change the script to get moisture data and 
include it in the CSV output. You could even send 
alerts when your plant needs some water. If you 
imported weather data from free public APIs such 
as openweathermap.org/api as well, you could see 
how changing conditions are affecting your plant! 


More than plants 

You can measure anything you want with 
this project, even growing youngsters, but why 
stop there? You’ve now had a taste of the power 
of OpenCV, which has many more capabilities 
than we’ve covered here. It is a powerhouse of 
computer vision that includes machine-learning 
capabilities that allow you to train your Pi to 
recognise objects, faces, and more. It’s a popular 
choice for robot builders and plays a major part 
in the autonomous challenges of Pi Wars. We can 
especially recommend pyimagesearch.com, which 
provided inspiration for this tutorial. E3 


TopTip A 


No plont? 


If you don’t have a plant or suitable environment, 
we’ve provided some sample images here: 

magpi.cc/omacNA 


plantbot.py [continued] 


> Language: Python 3 


039. boundRect = [None] *len(contours) 

040. for i, c in enumerate(contours) : 

041. contours_poly[i] = cv2. approxPolyDP(c, 3, True) 

042. boundRect[i] = cv2.boundingRect(contouns_poly[i] ) 

043. 

044. output_image = image. copy( ) 

045. mmPerPixel = angs["width ] / boundRect[0][2] 

046. highestRect = 1000 
047. lowestRect = 0 
048. 

049. for i in range(l, len(contouns)): 

050. 

051. # Too smol? 

052. if boundRect[i][2] < 50 on boundRect[i][3] < 50: 

053. continue 

054. 

055. # The first rectangle is our control., so set the ratio 

056. if highestRect > boundRect[i][1]: 

057. highestRect = boundRect[i][1] 

058. if lowestRect < (boundRect[i][1] + boundRect[i][3]): 

059. lowestRect = (boundRect[i][1] + boundRect[i][3]) 

060. 

061. # Create a boundary box 

062. cv2. rectangle(output_image, (int (boundRect[i][0]), 

int (boundRect[i][1])), 

063. (int(boundRect[i][0] + boundRect[i][2]), 

064. int (boundRect[i][1] + boundRect[i][3])), 

(255, 0, 0), 2) 

065. 

066. # Calculate the size of our plant 

067. plantHeight = (lowestRect - highestRect) * mmPerPixel 
068. print("Plant height is {0: .0f}mm" .format (plantHeight)) 

069. 

070. # Resize and display the image (press key to exit) 

071. resized_image = cv2.resize(output_image, (1280, 720)) 

072. cv2.imshow("Image", resized_image) 

073. cv2.waitKey(0) 
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Hack Lego Boost 

with Raspberry Pi 



Mike 

Cook 


Following last issue's introduction, this time we'll hack the Lego Boost kit 
some more, to gain extra control, and create some fun projects 


Veteran magazine 
author from the old 
days, writer of the 
Body BuiLd series, 
plus co-author of 
Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, 
and Raspberry 
Pi Projects 
for Dummies. 

magpi.cc/TPaUfT 


L ast issue, we saw how to connect the Lego 
Boost robotics set to the Raspberry Pi, and 
how to communicate with it in Python. 

This time we look at three example projects, 
where we explore the finer points of control that 
are normally hidden from you by the standard 
Lego software. 

The Lego Boost system communicates with a 
Move Hub that receives instructions, in real-time, 
over Bluetooth - it does not store its own set of 
instructions. So your model has to be in Bluetooth 
range all the time. This month we have three 
models to build, explore, and program. First, a 
simple but amusing use of the tilt sensor, then a 
machine to explore the performance of the colour 
sensor, and finally a colour sequence memory 
game. All parts for these projects can be built using 
the bricks that are included in the Lego Boost 
17101 set. 


Figure 1 Eyes Front - always start the software 
in this orientation 


Eyes Front 

We start with a very simple Lego build from 
the excellent book, The Lego Boost Idea Book, by 
Yoshihito Isogawa. It is a simple set of eyes that will 
always face to the front - well, in one dimension 
only. The idea is simple: measure the angle of the 
Hub and move the built-in motor to compensate for 
that movement. The Lego build is simple enough 
- see Figure 1. We also have full step-by-step 
pictorial build instructions on our GitHub repository 
(magpi.cc/dhaAam). The code to drive it is simple, 
but not as simple as you might hope. 


Eyes Front software 

The Python code for driving this is shown in 
the Eyes_front.py listing, and the alternative Lego 
language code is shown in Figure 2. It is interesting 
to note the difference in performance of the two 
code versions. The Lego language has a slow, 
hesitant movement, whereas the Python code has 
a much more robust feel about it. We did find that a 
straight translation from the graphics language into 
Python produced a system that would occasionally 
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Eyesjront.py 

DOWNLOAD 

THE FULL CODE: 

> Language: Python 3 

magpi.cc/dhaAam j 

001. 

#!/usr/bin/env python3 

036. 

def adjust(movehub) : 


002. 

# coding=utf-8 

037. 

maxA = 88 # maximum 

angle 

003. 

# Eyes Front - move motor A to match tilt angle 

038. 

targetAngle = tiltAngle # so it won't change 

004. 

# By Mike Cook March 2019 


during this function 


005. 


039. 

if targetAngle > maxA: # limit target angle to 

006. 

from time import sleep 


approx +/- 90 Degrees 


007. 

from pylgbst import * 

040. 

targetAngle = maxA 

008. 

from pylgbst.movehub import MoveHub 

041. 



009. 

from pylgbst.peripherals import TiltSensor 

042. 

if targetAngle < -maxA: 

010. 


043. 

targetAngle = -maxA 

011. 

motorAngle = 0 

044. 



012. 

tiltAngle = 0 

045. 

requiredMove = int (targetAngle - motorAngle) # 

013. 

shutDown = False 


amount required to move 


014. 


046. 

if abs( requiredMove) 

>4: # to reduce jitter 

015. 

def main() : 

047. 

print ("Moveing", requiredMove) 

016. 

print ("Eyes front - move the eyes to the front") 

048. 

movehub.motor_A. 

ngled( requiredMove, 0.02) 

017. 

conn=get_connection_auto () 

049. 

sleep(0.5) 


018. 

print ("Flub connected, press Green button to end") 

050. 



019. 

try: 

051. 

def callbackTilt (roll, pitch, yaw): 

020. 

movehub = MoveFlub(conn) 

052. 

global tiltAngle 


021. 

setup(movehub) 

053. 

#print("Tilt roll:%s 

pitch:%s yaw:%s" % (roll. 

022. 

while not shutDown: 


pitch, yaw)) 


023. 

adjust(movehub) 

054. 

tiltAngle = pitch * 

1.4 # under reporting pitch 

024. 


055. 



025. 

finally: 

056. 

def callback_A_angle(paraml) : 

026. 

movehub.tilt_sensor. unsubscribe (callbackTilt) 

057. 

global motorAngle 


027. 

movehub. motor_A.unsubscribe(callback_A_angle) 

058. 

motorAngle = paraml 


028. 

movehub.button. unsubscribe(call_button) 

059. 



029. 

conn. disconnect^) 

060. 

def call_button(is_pressed) : 

030. 


061. 

global shutDown 


031. 

def setup(movehub) : 

062. 

if not is_pressed : 


032. 

movehub.tilt_sensor. subscribe (callbackTilt, 

063. 

print( "Closing Down") 


mode=TiltSensor.M0DE_3AXIS_FULL, granularity=l) 

064. 

shutDown = True 


033. 

movehub. motor_A. subscribe(callback_A_angle, 

065. 




granularity=l) 

066. 

if _name_ == ' _main_ 


034. 

movehub.button. subscribe(call_button) 

067. 

main() 


035. 






rotate outside the required parameters. This was 
caused by sending the motor commands too quickly 
- that is, before the previous one had finished. A 
small delay seemed to be the only cure. 


The colour sensor 

Next up, we wanted to make a Simon game 
using coloured tiles and the colour sensors, but 
we ran into difficulties getting all the colours 



▲ Figure 2 The Lego Language way to program Eyes Front 
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► Figure 3 A rendered 
image of the 
sensor tester 



Top Tip 

A 

Setting the 


initial tile 


position 



The sensor tester 
should be wound 
back so the tile 


is touching the 
sensor before 
starting the Hub. 
Use your finger 
and thumb on the 
crank to wind the 
tile back. 


▼ Figure 4 CoLours 
reported against 
distance 


recognised at a fixed distance. We thought it was 
a shame we did not have some sort of machine to 
test the colour sensor's performance, but then we 
remembered that this was Lego and we could build 
one! So the next project turned out to be a colour/ 
distance sensor test bed, which proved to be fun and 
very interesting. The Lego model for this is shown 
in Figure 3, and step-by-step build instructions and 
software are again available on our GitHub repo. 


The colour sensor results 

Each tile colour was tested, and the software 
produced a CSV file we could import into any 
spreadsheet software for analysis. There were a 
total of 149 readings for each tile, giving a grand 
total over the six colours of 894 readings - for each 
parameter, distance sensor, and colour number. 
The raw CSV files are again on our GitHub repo, 
but in summary it is fair to say that when the tile 
was at a range where the colour sensor worked, the 
distance sensor produced nonsense. The colour 
sensor’s performance is summarised in Figure 4; 
( not a colour’ is number 255 and is off the graph. 


The colour sensor conclusions 

At close distances, the sensor would produce 
readings of black or no colour - 0 or 255 - then 
there would be a range where the reported colour 
was wrong, or would change from reading to 
reading. Then you got a period where the colour 
was consistent, before going into the oscillating 
values again, and finally ending up as no colour. 

The takeaway information from this was that all 
colours were correct from 6.17 to 16.18mm. That 
is a mid-range of 10.01mm, therefore the optimal 
range is 11.175 mm; unfortunately, this is a half stud 
quantity, making it difficult to achieve with Lego. 


Simon game 

We know that ambient light will affect the 
colour sensor’s performance, so we set out to try 
to exclude as much of it as possible. The result is 
that we built a box around the sensor with a slot in 
the top where we could insert the appropriate 2x4 
colour tile. This is shown in Figure 5 - again, full 
step-by-step instructions are on our GitHub repo. 
The only tile we had trouble with was the green one: 
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colour_simon.py 

► Language: Python 3 


001. 

#!/usn/bin/env python3 

039. 

far = 2 

002. 

# coding=utf-8 

040. 

while fail < maxFails and not shutDown: 

003. 

# Colour Simon 


number of fail attempts before reset 

004. 

# By Mike Cook March 2019 

041. 

print("a sequence of length", far) 

005. 


042. 

saySeq(far) 

006. 

import time., random., os 

043. 

if getSeq(far) != -1 and not shutDown 

007. 

from pylgbst import * 


if entered sequence is correct 

008. 

#import pylgbst 

044. 

far = far + 1 

009. 

from pylgbst.movehub import MoveHub 

045. 

if far <= maxLength: 

010. 

from espeak import espeak # sudo apt install 

046. 

espeak. synth (yes") 


python3-espeak 

047. 

print( Yes - now try a longer 

011. 

espeak.set_voice = 'en' 


one" ) 

012. 


048. 

time.sleep(l) 

013. 

random. seed() 

049. 

espeak. synth( adding one more") 

014. 

shutDown = False 

050. 

time.sleep(l) 

015. 

lastColour = 255 ; updateColour = 0 

051. 

fail = 0 # reset number of fails 

016. 

maxLength = 25 # maximum sequence before we 

052. 

else: 


decide you are cheating 

053. 

if not shutDown: 

017. 

sequence = [ random. randint(0, 3) for c in 

054. 

fail = fail +1 


range (0, maxLength)] 

055. 

print ("Wrong", fail, "fail") 

018. 

maxFails = 3 # number of fails before game ends 

056. 

if fail < maxFails: 

019. 

playingColours = 

057. 

espeak. synth( "no" ) 


["blue", "green","yellow","red","white", "black"] 

058. 

print("try that one again") 

020. 

translateColours = [5, 5,5,0,5,1,5,2,5,3,4] 

059. 

espeak. synth( "try that one 

021. 

playingToLego = [3,5,7,9,10,0] 


again") 

022. 


060. 

else : 

023. 

def main() : 

061. 

print ( "maximum tries 

024. 

global shutDown, movehub 


exceeded" ) 

025. 

print ("Colour tile Simon - press the green hub 
button to connect") 

062. 

espeak. synth("maximum tries 

exceeded" ) 

026. 

conn=get_connection_auto( ) 

063. 

time.sleep(2) 

027. 

print("Trying to connect Hub") 

064. 

espeak. synth("your score is" 

028. 

try: 

065. 

time. sleep(l) 

029. 

movehub = MoveHub(conn) 

066. 

espeak. synth(str(far- 1)) 

030. 

print("Hub now connected - press Green 

067. 

time. sleep(l. 5) 


button to end") 

068. 

if far > maxLength and not shutDown: 

031. 

init() 

069. 

print("Well done Master Mind") 

032. 

espeak. synth( Colour Simon game' ) 

070. 

espeak. synth("this is too easy for 

033. 

time. sleep(l) 


you") 

034. 

while not shutDown: 

071. 

shutDown = True 

035. 

fail = 0 # number of fails 

072. 

if not shutDown: 

036. 

#generate new sequence 

073. 

espeak. synth("Game over") 

037. 

for c in range(0,maxLength) : 

074. 

print("Game over - Your score 

038. 

sequence[c] = random. randint(0, 4) #use 


is",far-l) 


five colours 

075. 

print("Try again 1 ) 
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▲ Figure 5 Simon 
sensor with red tile 


it would not read when the smooth face was placed 
towards the sensor, but only the other way round. 
All the other tiles worked either way round. 


Top Tip A 


The Boost 

distance 

sensor 


Remember that 
the distance 
sensor returns 
values in inches, 
at inch or half 
inch intervals. 

This gives a 
stepped response 
for distances 
over an inch. At 
distances under 
an inch, values 
are returned but 
they are not in the 
same range as 
bigger distances. 
White tiles are the 
best for distance 
measurement. 


Simon software 

The software for the Simon game is shown 
in the colour_simon.py listing. The colours of the 
current sequence are called out using the speech 
synthesizer eSpeak; if you don’t have this installed, 
then a simple sudo apt install python3-espeak 
from a Terminal window will install it. The sequence 
is also displayed on the Hub’s LED. Each time you 
get a sequence correct, an extra colour is added onto 
the end and getting a sequence wrong for three 
consecutive times results in that round being over. 
You can quit at any time using the Hub’s green 
button. The fact you have physical colour tiles 
makes the initial stages simple, as you can simply 
put them in the correct order. 


Customising the software 

You can change the number of times you get 
to complete a sequence by changing the maxFails 
variable. Sometimes we think that three attempts 
is a bit much when the sequence gets long. Of 
course, you can simply write down the sequence, 
but that defeats the object of the game. The 
maxLength variable determines how long a sequence 
to generate before the program decides you are 
cheating and shuts down. You can comment out or 
simply turn off the audio if you want the sequence 
to be delivered in the form of the LED colour only. 
You could replace the synthesizer sounds with 
samples, for better quality. 



▲ Figure 6 A rendered image of the Simon sensor 


Virtual Lego 

The step-by-step instructions on our GitHub 
repo are generated by a free software application 
called Studio 2.0. This is a 3D CAD system that 
can be used to build a virtual Lego model, view it 
from all angles, and produce staggeringly realistic 
photographic-quality rendered images of your 
model. Figure 6 is the rendered version of the 
photograph we have in Figure 5. The application is 
written by BrickLink, and you can take your model 
and generate an order for exactly the bricks you want 
to generate the real thing, but this can be expensive. 


09 


Studio 2.0 

Unfortunately, Studio 2.0 is not available 
for Linux, so you can’t run it on the Raspberry Pi, 
but there are Windows and macOS versions. It is 
actively being supported, unlike the older official 
Lego tool LDD (Lego Digital Designer) which seems 
to have been neglected recently - these older 
models can be imported into Studio 2.0. There are 
still some things that Studio 2.0 will not currently 
cope with, like flexible linkages, but no doubt they 
will appear in due course. See our GitHub repo for 
notes on setting up Studio 2.0 to get the missing 
Boost-specific parts like the Move Hub. 


In conclusion 

In the final part of this series, we will explore some 
of the things you can do to make music using the 
Lego Boost system. EH 


Disclaimer 


LEGO® is a trademark of the LEGO Group of 
companies, which does not sponsor, authorise, or 
endorse this article. 
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COlOUr_SimOn.py (continued) 


076. 

time.sleep(2.0) 

113. 


print ("Now you try") 

077. 

else: 

114. 


for press in range(0, length): 

078. 

espeak. synth("closing down good bye") 

115. 


if shutDown: 

079. 


116. 


return 1 

080. 

finally: 

117. 


attempt = getTileQ 

081. 

print ( "shutting down") 

118. 


movehub.led. set_color(playingToLego[5] ) # 

082. 

movehub.button. unsubscribe (call_button) 


turn off LED 

083. 

movehub.color_distance_sensor. 

119. 


if attempt != sequence[press]: 


unsubscribe (callback_colour) 

120. 


time.sleep(0.8) 

084. 

conn.disconnectQ 

121. 


return -1 

085. 


122. 


return 1 

086. 

def initQ: 

123. 



087. 

movehub.led. set_color (playingToLego[5]) 

124. 

def 

callback_colour(colour, distance) : 

088. 

movehub.button. subscribe (call_button) 

125. 


global lastColour, updateColour 

089. 

movehub.color_distance_sensor. subscribe ( 

126. 


if distance <= 1.2: 


callback_colour, granularity=0) 

127. 


if colour != 255 and lastColour != colour 

090. 



and 

colour!= 0: # ignore no colour 

091. 

def getTileQ : 

128. 


updateColour += 1 

092. 

global lastColour, updateColour 

129. 


#print(colour) 

093. 

while updateColour < 3 : 

130. 


if updateColour > 2 : 

094. 

if shutDown: 

131. 


lastColour = colour 

095. 

return 5 

132. 


if colour == 255 : 

096. 

#print("colour",playingColours[correctColour 

133. 


lastColour = 255 


(lastColour)]) 

134. 


else: 

097. 

updateColour = 0 

135. 


lastColour = 255 

098. 

espeak. synth (playingColours[ 

136. 




correctColour (lastColour)]) 

137. 

def 

correctColour(colour) : # translate LEGO 

099. 

movehub.led. set_color(playingToLego[ 


colours to playing colours 


correctColour(lastColour) ]) # turn on LED 

138. 


if colour == 255: 

100. 

return correctColour(lastColour) 

139. 


correctColour = 5 # black 

101. 


140. 


else: 

102. 

def saySeq(length) : 

141. 


correctColour = translateColours[colour] 

103. 

for num in range(0, length): 

142. 


return correctColour 

104. 

espeak. synth (playingColours[sequence[num]]) 

143. 



105. 

movehub.led. set_color( 

144. 

def 

call_button(is_pressed) : 


playingToLego[sequence[num]]) 

145. 

global shutDown, updateColour 

106. 

time. sleep(0. 8) # time between saying colour 

146. 

if not is_pressed : 

107. 

movehub.led. set_color(playingToLego[5] ) 

147. 


print ( Closing Down") 

108. 

time. sleep(0. 5) 

148. 


shutDown = True 

109. 


149. 


updateColour = 0 

110. 

def getSeq(length) : 

150. 



111. 

movehub.led. set_color(playingToLego[5] ) # turn 

151. 

if . 

_name_ == '_main_' : 


off LED 

152. 


mainQ 

112. 

espeak. synth( "Now you try") 
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Start creating GUIs 
with C and GTK 


0 
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Long 


Simon Long 
is a software 
engineer working 
for Raspberry Pi, 
responsible for 
the Raspberry 
Pi Desktop on 
both Raspbian 
and Debian. 
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With a grounding in C programming, you 
start creating GUIs using GTK 

I n the first half of the book, An Introduction to 
C & GUI Programming , we learn the basics of 
the C language, and see how to use it to write 
text-only programs to run at the command line. 

Looking at the keywords and library functions 
covered, it isn’t obvious how to create everything 
required for a full GUI - desktop, windows, icons, 
mouse pointer, and so on - with them. 

It is entirely possible to do so in C, but to be 
honest, it would be incredibly long-winded and 
time-consuming. You need to find the screen 
buffer in memory - the part of memory that 
represents the pixels which make up the desktop 
on the screen - and then write new pixels to it for 
each window; you then have to write even more 
pixels to it to show where the mouse cursor is. You 
then have to monitor when the user moves the 
mouse, and redraw the pointer each time, and then 
when the user clicks the mouse button, you have 
to work out where on the screen the pointer is and 
whether it is on top of a window, and so on... 


are ready to 


Funnily enough, that isn’t how it’s usually 
done in practice - life is too short! Most of this 
functionality has already been written for you. 
Windowing systems like X provide most of the 
underlying features, and then user interface 
libraries provide a convenient means of creating 
GUI applications which work with the likes of 
X; all you need to do is choose a suitable user 
interface library, and use the predefined functions 
in it in your C program. 

There are lots of user interface libraries 
available; some are designed to work with a 
particular desktop environment like Windows or 
macOS, while others are cross-platform and can 
work in a choice of desktop environments. The 
one which is used most often in the Raspberry Pi 
Desktop included with Raspbian is called GTK, and 
that’s the one we are going to look at here. 


An Introduction 
to C & GUI 
Programming 

For further tutorials on how to start coding 
in C and creating GUIs with GTK, take a 
look at our new book, An Introduction to 
C & GUI Programming. Its 164 pages are 
packed with all the information you need 
to get started - no previous experience of 
C or GTK is required! 
magpi.cc/GUIbook 


lN TRODUCnON 

C&GUI 

PROGRAMMING 


What is GTK? 

GTK (formerly known as GTK+) is short for ‘GIMP 
ToolKit’. Its website (gtk.org) describes it as “a 
multi-platform toolkit for creating graphical 
user interfaces”, and it was originally written to 
provide the user interface elements used to create 
the GIMP picture-editing program. 

It has grown beyond that into a general user 
interface toolkit, and is now one of the most widely 
used user interface libraries on the Linux desktop. 

The fundamental building blocks of GTK 
projects are called widgets. Everything you see 
on the screen - a window, a button, a label - is a 
widget. The GTK library does all the work required 
in creating widgets - all you need to do is to tell it 
what widgets you want, whereabouts you want to 
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put them, and what you want them to do, and GTK 
will manage everything else for you. 

To give you an idea of what ( manage everything 
else’ means, imagine the situation described 
above where you are manually creating a window 
by drawing pixels by writing data to the screen 
buffer. If the user clicks on the window title bar 
and drags it to another place on the screen, you 
have to detect that the mouse has been clicked, you 
have to track that it is being moved, and you have 
to redraw the window at each point as it moves, 
restoring what was underneath it in the areas 
from where it has moved. Just dragging a window 
would be hundreds of lines of code - but with GTK, 
you create a ‘window’ widget (with a single line of 
code) and all of that is taken care of for you. 

Libraries like GTK therefore make the creation 
of rich graphical user interfaces relatively easy, 
and you may be surprised by just how little code 
you need to write to get something working. 


GTK 2 and GTK 3 

One thing worth noting at this point is that there 
are two versions of GTK in use. The current version 
is GTK 3, and this is still under active development 
- it changes quite a bit between releases. 


For this reason, many people prefer to use 
the older version, GTK 2. This offers most of the 
same functionality, but it is stable code which 
doesn’t change very much any more. Some say 
that it is always better to use the latest and 
greatest version of anything, but more cautious 
old engineers (like your author) tend to prefer the 
older version that has had a lot more testing and 
with which people have stopped fiddling about! 

In terms of the examples we are looking at here, 
there aren’t that many significant differences 
between the two, but just to be clear, the 
examples in this tutorial series will use GTK 2. 

□ Libraries like GTK make the creation 
of rich graphical user interfaces 
relatively easy 3 

A note on theming 

One of the powerful features of GTK is theming. 

The appearance of every widget in GTK can be 
customised in pretty much every detail, from the 
colour of the text to the shape of the corners on a 
button. This customisation is completely separate 
from the actual coding of a GTK application; 
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► The output of 

pkg-config is a Long 
List of the flags and 
Libraries that need 
to be passed to the 
compiLer to build a 
GTK program 



instead, the appearance of widgets is controlled by 
the current theme which is in use on the system 
on which the GTK applications are running. 

Creating a theme is beyond the scope of 
this series - it’s quite a complicated and fiddly 
procedure. All the example screenshots in this 
guide were taken from a Raspberry Pi running the 
Raspberry Pi Desktop environment, which uses a 
custom theme called PiX. If you are working with 
GTK on a different computer with a different theme, 
your widgets may look slightly different from those 
pictured, but the code you write will be the same. 


Your first GTK program 

Let’s create a simple GTK program. Open your 
favourite text editor, and write the following. 

#include <gtk/gtk.h> 

int main (int argCj char *argv[]) 

{ 

gtk_init (&argCj &argv); 

GtkWidget *win = gtk_window_new (GTK_ 
WINDOW_TOPLEVEL); 

gtk_widget_show (win); 
gtkjnain (); 
return 0; 

} 

We said you didn’t need much code! Let’s look at 
that line-by-line before we try to run it. 


#include <gtk/gtk.h> 

This is an instruction to the preprocessor to tell it 
that we are writing a GTK program, and to load the 
GTK header files. Without this, the compiler won’t 
recognise any of the GTK library functions that we 
are going to use. 

int main (int argCj char *argv[]) 

This is the standard starting point of a C program 
- a main function with some arguments and a 
return value. 

gtk_init (&argCj &argv); 

This is our first piece of GTK code. You need to call 
gtk_init at the start of every GTK program - this 
initialises all the internal variables used by the GTK 
library and sets it up ready to use. (Note that any 
command-line arguments supplied to the program 
are passed on to the GTK library via the arguments 
to this function.) 

GtkWidget *win = gtk_window_new (GTK_ 
WINDOW_TOPLEVEL); 

This creates a widget of type GtkWindow. For every 
type of widget in GTK, there is a _new function 
which creates an instance of that widget and 
returns a pointer to it. 

gtk_widget_show (win); 
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This tells GTK to show the widget we have just 
created. The previous line created the widget in a 
hidden state; widgets can only be seen if they are 
unhidden with a _show call like this. 

gtkjnain (); 

The gtkjnain call runs the main loop of GTK; this 
effectively hands control of the program to GTK 
itself, which then processes any user events like 
button pushes to control the user interface you 
have created. 

return 0; 

Formally, as this is a C program with the main 
function returning an integer value, we need to 
return a value. However, this is largely pointless 
with a GUI program where the command line, 
and hence any return value, is usually never seen 
anyway; it’s included here for completeness, but 
to save space, it won’t be in any other examples in 
this tutorial series. 

That’s really all there is to it - that’s the simplest 
GTK program which will do something sensible. 
Type it in using your favourite editor and save it as 
gtktest.c. Now we need to build and run it... 

□ We need to tell the 
linker that we want the 
program linked with the 
GTK library files □ 


There is a utility called pkg-config that helps 
here, pkg-config is a tool which generates 
the arguments required by gcc in order to use 
additional libraries. Try typing pkg-config 
--cflags --libs gtk+-2.0 at the command line 
and look at the output. You’ll see a list of strings - 
those which start -1/ are the directories where the 
GTK include files are stored, and those which start 
-1 are the names of the GTK library files. 

All of these need to be added to the gcc 
command line in order to build our GTK program, 
so the pkg-config command is enclosed within 
back-ticks ('), like so: 


gcc 'pkg-config --cflags --libs gtk+-2.0' 
gtktest.c -o gtktest 


If you run this, you should end up with an 
executable file called gtktest. Run this by typing: 

./gtktest 

...and see what happens. 

You should see a small grey square window 
open somewhere on your desktop; it won’t do 
much, but you can drag it around and minimise 
and maximise it. If you press the X in the top- 
right corner, the window closes, but if you look in 
the Terminal window from which you ran gtktest, 
you’ll see the program is still running. This is 
because closing a window doesn’t terminate the 
gtkjnain function, which will carry on running 
until you hit CTRL+C in the Terminal window. 

Congratulations! You’ve just created your first 
GUI application with GTK. In the next guide, we’ll 
put something onto that empty window. E 3 


Building a GTK program 

If we’re writing a standard command-line C 
program, we can just use the gcc compiler to 
build our source file - gcc gtktest. c would 
produce an executable file. However, things are 
not quite so simple if we are using an external 
library like GTK. 

First, we need to make sure that the relevant 
GTK libraries are installed. To do this, type sudo 
apt-get install libgtk2.0-dev into a Terminal 
window and answer yes to any prompts - this 
installs the developer libraries for GTK 2. 

Now we need to tell the compiler where to find 
the GTK header files, and also we need to tell the 
linker that we want the program linked with the 
GTK library files, or all the ( GTK-ness’ we want to 
use will be unavailable. 
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POWER UP YOUR IN-CAR ENTERTAINMENT 

WITH RASPBERRY PI. BY ROB ZWETSLOOT 


O ne of the ultimate mods for modern cars 
is to replace or upgrade the entertainment 
system. This can range from something as 
small as adding new speakers, to replacing the 
stock stereo, or - in our case - creating a custom 
computer purpose-built for your car. 

The Raspberry Pi is fantastic for this task. It’s 
small enough that it’s easy to hide, and powerful 
enough to handle simple telemetry, dash-cam 
recording, GPS, and more. Thanks to AutoPi, you 
won’t need to be deep in the bowels of your car 
snipping wires, either, and you can control it using a 
cloud-based service. Let’s make your car futuristic! 









WARNING! 


In-car enterta 


From radios to computers 

I t may surprise you to learn that it was back 
in 1904 that the first in-car entertainment 
system - in the form of a car radio - was 
demonstrated at the Louisiana Purchase 
Exposition (an old-time world’s fair) by the 
father of radio himself, Lee de Forest. That 
must have been extraordinary - cars themselves 
a very new concept, and radio not too old either. 

It wasn’t commercially viable at all, but can 
you imagine? 

By the 1920s, radios began to be installed in 
cars, with AM-radio-equipped cars numbering 
9 million by the late forties. 

FM, tape, and beyond 

It’s in the fifties that in-car entertainment started 
to resemble what we see in cars today. First was 
FM radio. In the sixties, tape players in the form 
of cassette and 8-track started appearing. Now 
you could choose your music in your car. How 
fantastic is that? 

From there, CD players exploded in the 
nineties, followed by the classic 'back of the 


ll IILhI 


A classic CD/stereo head unit, removable to deter 
enterprising thieves 


For the safety of yourself ^ 

and other motorists, you need 

I to make sure your eyes are on 
the road while driving. This is also 
the Law in many countries. Make 
sure your interactions with your 
new computer are minimal while 
driving, and do not under 
any circumstances play 
videos for yourself. A 


▼ The 1937 Philips 
Auto Radio weighed 
24 kg and took up 
eight litres of space 
on the floor 


This style of stereo 8-track unit from a 1978 
AMC Matador almost defines the look of cars in 
seventies and eighties cinema. Credit: CZmarlin 


seat’ DVD players for the kids, satnav 
boxes you’d stick to the windscreen, 
dash-cams, auxiliary in, USB in, SD 
card slots, Bluetooth syncing, and 
even WiFi connectivity. It’s frankly 
incredible how quickly we’ve moved 
from a pouch of CDs in the glove 
compartment to your podcast 
picking up where you left it as you 
turn on your car. 

We can do better 

The stock systems aren’t always 
amazing, though, are they? They have potential 
but the UI is lacking or it’s missing some key, 
seemingly obvious feature. Ours sometimes 
crashes during navigation, which can be 
fun. People have been replacing their in-car 
entertainment with custom computers for years; 
however, it’s now far easier than ever thanks to 
the Raspberry Pi. 




















Install the car computer 


A step-by-step guide to installing a Pi-bosed ICE system 


SHOPPING 

LIST 


> AutoPi DongLewith OBD-II 
Extension Cable 

magpi.cc/DWTGpi 


> AutoPi Raspberry Pi 3 Adapter 

magpi.cc/vsuXBp 

> 2 x GoPro adhesive mounts 

magpi.cc/KqMiTE 

> Raspberry Pi Camera Module 

magpi.cc/camera 


> Raspberry Pi 3 B or 3 B+ 

> Raspberry Pi 7 -inch 
Touchscreen Display 

magpi.cc/ajiRqK 


> SmartiPi Touch case 

magpi.cc/snAgQD 


SmartiPi assembly 

The SmartiPi Touch case is pretty easy to 
put together. If you want to make sure you’re 
doing it 100% correctly, you can always follow the 
YouTube assembly guide: magpi.cc/ZMwmBf. 


Add the AutoPi adapter 

The AutoPi hardware comprises two parts: 
the adapter board that slots onto the Raspberry 
Pi like a HAT, and the OBD-II dongle. The adapter 
board’s spacers need to attached to both the Pi and 
the adapter before affixing it onto the GPIO pins 
and fastening the board to the Pi with some nuts. 












WARNING! 

Connecting to the 
OBD port of your car is 
usually fine, but double- 
check your warranty just in 
case. Do not attempt to 
tune your car via this 
k interface, though. 


□ Don't place it in a location that will 
obscure your field of vision □ 


You'Ll need a 
touchscreen to see 
theAutoPi interface 


Slot the dongLe on 
top of the adapter 
board and Pi 


◄ 


T 


Attach the dongle 

With the adapter in place, you can now add 
the dongle on top and fasten it in place with some 
screws. You’ll need to take it apart first and remove 
the Pi Zero inside. There will be a little hanging 
cable to connect to the 4G modem, which attaches 
to a USB adapter that goes into the Raspberry Pi. 


Set up the SD card 

You can use the provided microSD card, 
but we always find it best to flash a new one. Grab 
the latest AutoPi image (magpi.cc/rjUgKg) and 
then install it using Etcher to your microSD card. 
Not used Etcher before? Learn how in our handy 
video: magpi.cc/Zibvmu. 



Finish and mount 

Now you’ve got a working car computer 
with a touchscreen, you can mount it in your car. 
They are some fairly common sense rules on how 
to do this. The main takeaway is: don’t place it in a 
location that will obscure your field of vision and/ 
or be distracting. The usual ‘bottom middle of the 
windscreen’ with GoPro mounts is quite a good 
spot, otherwise you can mount it to the dash if 
you’re confident in your abilities. 

























▲ Once connected, the 
AutoPi system should 
boot up 

► The car's OBD-II port 
can often be found 
under the dashboard 



Connect to OBD 

You can now connect to your car computer 
using the OBD-II port of your car - you may have 
to Google your car make and model to find out 
where it is, but a lot of the time it’s under the 
dashboard. Connect the OBD extender between it 
and your Raspberry Pi. 


Initial startup 

The OBD-II port powers your AutoPi system, 
and it should boot up once it’s connected. By 
default, there is no graphical user interface for 
AutoPi (you usually just read the data online on 
another computer); however, we can change that. 
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Create an AutoPi account 

Head to my.autopi.io and log in to your 
AutoPi account - if you don’t have one, it’s free 
to register. If you’re using a brand new dongle, 
you can register it here so that you can then get 
data from it and make changes. If you’ve used the 
dongle before, you’ll need to generate a new ID by 
going to the Terminal and using the command: 

grains.get id 


Install a graphical interface 

You’ll need to install a graphical inteface 
using Chromium in web kiosk mode. The full 
guide on how to install the interface and configure 

AutoPi.io ® 


it can be found here: magpi.cc/accZdy. You can 
tweak the config file to your specific needs. 


Configure your interface! 

The basics are all done! From here you 
can start adding extra functionality using 
the other add-ons, and rearrange the in-car 
interface to your heart’s content. Enjoy your new 
car computer! 


□ Log in to your AutoPi 
account - if you don't have 
one, it's free to register □ 
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Upgrade your computer 

Want to da more? Here are some top tips,,, 


A utoPi is extremely smart - plugging in 
specific sensors and inputs allow you to 
quickly add extra functionality to your 
computer. Here are some classics. 

Dash-cam 

Dash-cams have risen in popularity in recent 
years for many reasons - mostly safety and 
insurance related, but if you’re taking a quick trip 
around the Niirburgring it’s nice to have a record 
of your fastest lap. With our specific setup, you 
can actually use the Raspberry Pi Camera Module; 
however, a USB webcam will also do the trick if 
you have a spare one. 




Parking sensor 

External parking sensors are a great for helping 
you park while reversing, and it’s a popular 
addition on many cars. If your car doesn’t have 
one by standard, you can add external ones that 
connect to your AutoPi. Even if you do have rear 
sensors, it never hurts to have a front parking 
sensor for when you’re in a really tight spot. 


Voice control 

A lot of modern cars now also include voice 
control as standard. They’re usually not amazing 
especially compared to your smartphone, but 
they’re installed nonetheless. By plugging in a 
USB microphone you can create custom voice 
commands for your AutoPi, which can be much 
safer than using the touchscreen while driving. 













Book of 

Scratch 



\,%9 

\ 

% 


Volume 1) Simple coding for total beginners 



Simple coding for total beginners 


The first 

Code Club book 

has arrived! 

Learn to code 
using Scratch, the 
block-based language 

Follow step-by-step 
guides to create games 
and animations 

Use the magic glasses 
to reveal secret hints 

Includes 24 exclusive 
Code Club stickers! 

The special spiral 
binding allows 
the book to lay flat 


Available at: magpi.cc/CCbookl 
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McitfPi I REVIEW 


balenaFin 


SPECS 


► balena ► balena.io/fin ► From £119 / $155 


POWER RANGE: 

6 to 24 V 

COPROCESSOR: 

Artik 020 with 
32-bit ARM 
M4 core 

STORAGE: 

eMMC 

8/16/32/64GB 

PORTS: 

mPCIe, nano 
SIM, HDMI, 

2 x USB 2.0 


▼ The balenaFin 
from the top and 
bottom - the Latter 
view showing 
the Compute 
Module attached 


A carrier board for the Raspberry Pi Compute Module 3 Lite, designed 
for the Internet of Things, Brian Corteil takes a walk on the WiFi side 


B alena was formerly known as Resin, io and 
is the developer of the cross-platform app 
Etcher, used for flashing OS images to SD 
cards and USB drives. The company also provides 
a platform for Internet of Things in the cloud - in 
its own words, “Balena is a complete set of tools 
for building, deploying, and managing fleets of 
connected Linux devices. 55 

Part of this set of tools is a carrier broad for 
the Raspberry Pi Compute Module 3 Lite (CM), 
called the balenaFin. You can think of it being 
like a PC motherboard, and it shares many of the 
same features. 

Useful loT features 

The hardware is designed for commercial use, 
for the Internet of Things (IoT), and has a few 


useful features to this end. These include a wide 
power input range, real-time clock (RTC), a micro 
coprocessor (Artik 020), WiFi/Bluetooth, and a 
full 40-pin I/O Raspberry Pi compatible header. 
There are also sockets for mPCIe, nano SIM 
(continuing the IoT theme), and HDMI, plus two 
USB 2.0 ports, power connectors, and a debug 
port for flashing the eMMC (8/16/32/64GB). The 
mPCIe socket can be used to add more storage 
or connectivity. 

The microprocessor can run real-time jobs and 
wake up the CM at predefined conditions - for 
example, at 16:00 each day, or when a response 
is required because an input changes status. The 
balenaFin internal WiFi antenna can be bypassed, 
and an external WiFi/BT uFL antenna added to 
improve the range of the WiFi/Bluetooth. 
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REVIEW I 


News flash 


As this review was being written, balena blogged 
about the next version of the balenaFin. Highlights are 
that the DSI display connector can be configured as a 
second camera port, allowing for stereoscopic camera 
functionality, and there’s PoE compatibility via a HAT. 


As with any new toy, the balenaFin was passed 
to our friendly electronics engineer, Rob Karpinski, 
and he made happy noises while he was looking at 
it - his final word when passing it back was “Nice. ” 
The build quality is of a high standard, with great 
attention to detail. 

Some tests 

So, where to start? First, the CM was installed in 
the balenaFin with a satisfying click. Following 
the guide on the Raspberry Pi website, the latest 
version of Raspbian was flashed to the balenaFin’s 
eMMC via the debug socket. Next, we connected 
a keyboard and HDMI monitor. On powering up 
with the supplied PSU, we were happy to see the 
standard Raspbian welcome screen, and were able 
to connect to our network via WiFi and update 
the system. 

We then tested the 40-pin header. For this, 
some HATs/pHATs from Pimoroni were selected, 
software downloaded, and we installed their 



It includes a sLot (far 
right) for a nano SIM 



□ You con think of it being like a PC 
motherboard and it shares many of the 
same features E3 


Python libraries and examples. First up was the 
Unicorn HAT HD; we loaded the rainbow example 
and it ran with without any issues. The Scroll pHAT 
was up next; once again, after loading the drivers 
and the examples, it worked first time. 

Next up was the RTC. Following the Pi Hut 
guide suggested by balena, we were able to update 
the RTC with the current time, and the time was 
still correct when it was rebooted without an 
internet connection. 

So, what is it good for? 

We can see the balenaFin being used in intelligent 
displays, monitoring/controlling equipment/ 
sensors - the normal IoT things. It would make 
a good contender for the brains of a robot, with 
the addition of a motor controller HAT. The 
inclusion of the 40-pin header allows the use 
of many HATs/pHATs to expand the function of 
the balenaFin. E 1 


Verdict 


The well-made 
balenaFin has 
some useful 
features - for 
signage, a control 
system, or even 
a robot. Being 
able to use HATs 
with it is useful 
for customising 
it to a project’s 
requirements. If 
you can afford it, it 
should be a good 
fit for your project. 

8/10 
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McitfPi I REVIEW 



SPECS 


HEADERS: 

Female 2x20- 
pin, male 30-pin 

BREADBOARD: 

Half-size - 
400 points 

COMPONENTS: 

5 x 10mm LEDs, 
5 x resistors, 
GND wire 


Verdict 


While the 
automatic 
connection of 
breadboard 
rows to GPIO 
pins reduces 
component 
placement 
flexibility, the 
Bridge is a neat 
solution to 
making circuit 
building easier for 
newcomers. Ideal 
for classroom use. 


A imed at making electronic circuit 
prototyping neater and easier, the 
Breadboard Bridge Pi integrates a 
half-size breadboard (included) and Raspberry Pi 
into one unit, while arranging the GPIO pins in 
handy numerical order. 

Coming in kit form, it requires the soldering of 
a female 40-pin GPIO header to the linking PCB, 
along with 28 male pins for 26 GPIO ports, 3V3 
power, and GND. You’ll then need to assemble 
the frosted black Perspex pieces to secure the 
breadboard and Raspberry Pi with nylon screws 
and standoffs. There’s also the option of placing 
a Perspex cover over the Pi, with a breakaway 
corner to allow room for the PoE four-pin header 
on the 3B+. 

No messy wiring 

With assembly complete, you can start placing 
components on the breadboard, each of its 


Breadboard 

Pi Bridge 


□ It soon becomes apparent 
how easy this makes it to 
create simple circuits with 
hardly any wiring □ 


A Wiring up a circuit is simple with the supplied 
LEDs, resistors, and ground rail connection wire 

near-side rows being connected to a numbered 
- and therefore easily identified - GPIO port on 
the PCB. Using the supplied five 10 mm LEDs 
and resistors, it soon becomes apparent how 


► RasPiO ► magpi.cc/beWjuO ► £12/$16 


Couple 0 breadboard to your Pi with GPIO 
ports in numerical order, By Phil King 




easy this makes it to create simple circuits with 
hardly any wiring. With the LEDs spanning the 
breadboard gutter and the resistors connecting 
them to the far ground rail, all you need is a single 
wire (supplied) to connect the latter to the other, 
near-side ground rail. 

This arrangement does have a few limitations. 
Since all the near-side breadboard rows are 
already connected to GPIO pins, you can’t place 
components sideways - they’ll need to span the 
gutter, or be placed on the unconnected near rows 
(to one side) or on the far side and connected with 
jumper wires. Even so, for basic circuits, it should 
make it much easier for physical computing 
newcomers to get started. ED 
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CoderDojo 
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A 


Can I start a 
CoderDojo club 
in my local area? 


CoderDojo is a global network of free, volunteer-led, project-based 
programming clubs for children aged 7-17. Dojos are championed by 
individuals all around the world who are passionate about giving young 
people the opportunity to learn to code. 


Starting 
fun and 

incredibly I 


rewardii 

ng experience 


You don't need to possess technical skills to start a Dojo. The most 
important attribute is that you can bring people together for a shared 
goal. 

We’re ready to support you by providing: 

Learning resources and guides A free event management system 

Certificate templates, digital badges, and giveaways 


"I started a Dojo to give my kids a place to meet other children also 
interested in programming and making games. I get to see them 
making new friends, learning from one other, and they loved it. 
Realising how I had created such a wonderful place for children has 
ignited a spark in me.” - 


- Maroes, CoderDojo NL 









REVIEW I 


PiTalk 

► SB Components ► pitalk.co.uk ► 



£ 58 / 


Turn your Pi into a 4G mobile phone with the PiTalk HAT 
from SB Components. PJ Evans keeps talking 


▲ Being a standard HAT, installation 
takes minutes and the software 
configures the Pi for you 


ver the past few years, we’ve been lucky 
to see the Raspberry Pi get more and more 
communication options. It’s no surprise 
then that there’s been great interest in getting 
Pi devices onto the mobile data network. SB 
Components’ PiTalk range does just that, except 
rather than stopping at just a data-capable device 
the PiTalk HAT turns your Pi into a fully-fledged 
smartphone with voice and SMS support. 


small touchscreens that can be added to create 
a more phone-like experience. 

To get everything running, software is supplied, 
but this is squarely aimed at the touchscreen. 
Although we were able to make voice calls, send 
SMS messages, and transmit data, the interface is 
poor to unusable without a touchscreen. 

It is not an end-user product, but rather 
something on which other projects can be based. 



SPECS 


MOBILE 

COMMUN¬ 

ICATIONS: 

UMTS/HSDPA 
and GSM/ 
GPRS/EDGE 

SPEAKER/ 
MIC: 

On-board 
jumpers 
and 3.5-inch 
connector 

LOCATION 

SERVICES: 

Quec Locator. 
Positioning 
based on 
cell tower 


Just add SIM 

The standard-size HAT features a Quetec SoC that 
adds everything the Pi needs to get on the mobile 
data network; you only need to provide a micro 
SIM. Our tests with EE met with failure, but a 
Vodafone SIM worked first time. As the HAT only 
uses serial communications, nearly all the GPIO 
pins remain unused and the HAT has Through’ 
pins for further expansion. SB offers a range of 


□ Perfect if you are interested in 
remote automation □ 

We were able to find an example project using 
Python to exchange SMS messages and trigger 
GPIO pins in response. It’s great for experimenting 
with smartphone technology, and perfect if you are 
interested in remote automation. EH 



Verdict 


While Let down by 
a tricky interface, 
the PiTaLk is 
ideal for makers 
planning remote 
monitoring 
projects. It’s better 
combined with 
a touchscreen. 

7/io 
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McitfPi I REVIEW 


JAM HAT 


SPECS 


► ModMyPi ► magpi.cc/jMxZCU 



► £ 7/$9 


A It connects directly on top of the 
Raspberry Pi and uses standoffs 
to fit securely to the board 


COMPONENTS: 

2 x Tactile 
'push to make’ 
buttons 


ModMyPi's board for adding lights, buttons, and a buzzer to the 
Raspberry Pi is a great solution for newcomers. By Lucy Hattersley 


6 x 'Traffic light’ 
LEDs (2 x red, 

2 x yellow, 

2 x green) 


l x Buzzer/ 
sounder 


Verdict 


It's a neat solution 
to adding buttons, 
LEDs, and a buzzer 
to a Raspberry Pi. 
You lose some 
of the fun of 
wiring everything 
up manually, 
but it'll be great 
for classroom 
environments. 

9/io 


M any Raspberry Pi starter projects involve 
LED lights, buttons, and buzzers. 

ModMyPi’s JAM HAT brings these 
components together into a single, simple board 
that slots neatly on top of the Raspberry Pi. 

On the board you’ll find six LEDs (two red, 
amber, and green), two ‘push to make’ buttons, 
and a single buzzer. These components lend 
themselves to many starter projects, and enable 
newcomers to explore the concepts of input 



A The JAM HAT adds six LED lights, two buttons, 
and a buzzer to the Raspberry Pi 


(buttons) and output (LEDs). For instance, 
you can build a traffic light system with a 
button crossing. 

Utilising Raspberry Pi’s HAT (Hardware 
Attached on Top) framework means all you need 
to do for setup is slot the JAM HAT on top of a 
Raspberry Pi. Four metal standoffs are used to 
secure the JAM HAT to the Pi, making for a secure 
teaching device for the classroom. ModMyPi has a 
guide to getting started, walking you through the 
assembly and setup process (magpi.cc/GBRhJb). 

Code base 

The JAM HAT works with Python or Scratch. 

In Python, it makes use of the new GPIO Zero 
1.5 library, which makes it easier to connect 
buttons and LEDs together in Python. ModMyPi 
worked with the GPIO Zero code team to put 
together sample projects - you can find this 
selection of sample code on ModMyPi’s GitHub 
site (magpi.cc/GZrVfm). 

Users at home might get more from wiring 
LEDs, buttons, and the buzzer directly to the GPIO 
pins via a breadboard. However, we think JAM 
HAT will be ideal for teachers looking for a neat 
classroom solution. It even has a passthrough 
GPIO header, so doesn’t restrict students from 
attaching further components. ED 
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THE OFFICIAL 


Raspberry Pi 

Beginner’s Guide 



The only guide you 
need to get started 
with Raspberry Pi 


Inside: 

• Learn how to set up the Raspberry Pi, 
install an operating system, and start using it 

• Follow step-by-step guides to code your 
own animations and games, using both the 

Scratch and Python languages 

• Create amazing projects by connecting 
electronic components to the Pi’s GPIO pins 

Plus much, much more! 


£10 with FREE 
worldwide delivery 


B-J HE 1 0FF,C 'AL 

raspberry pi 

Beginner’s Guide 

H ow to use your new compiler 


Buy online: magpi.cc/BGbook 

























McitfPi I REVIEW 


10 Best: 

Laptop kits 
& projects 



CrowPi 


A briefcase PC 


Want to make your Pi more portable? 
Here are some of the best ways,,, 

R aspberry Pi devices powering old laptops and 
custom mini computers have always been 
a popular idea in the Pi community. As tech 
compatible with Pi and other hardware becomes 
more available, so has the feasibility of these kind of 
projects - so much so, that you can now get all-in-one 
computer kits. Here are some of our faves. ED 


pi-top 3 


True original 

This Lean, green, Kickstarted module laptop 
machine is the original Raspberry Pi laptop 
kit. There are several variations of it that sell 
for a wide variety of prices, but the original 
laptop configuration remains a favourite to 
this day. 

► £245 / $320 

► pi-top.com 



Another crowdfunded Laptop, the CrowPi looks Like a spy kit worthy 
of Bond himself. Full of cool components and connectivity, it’s a 
great way to carry fun Pi-powered projects around with you. 

► £ 186/$239 

► magpi.cc/DcAWER 



Computer Kit 

Touch 


Screen and keyboard, 
no folding 

Kano has been producing Pi- 
powered computer kits for years, 
and this version is a touchscreen 
tablet with an additional external 
keyboard. While not a traditional 
style of laptop, it does function 
fairly similarly to one. 

► £280 / $280 

► magpi.cc/gLpTVF 


RasPad 


Raspberry Pi Tablet 

This tablet computer kit is an interesting 
implementation of the Raspberry Pi, as 
it's one part of tablet as well as one part 
mobile-powered Pi - you can easily 
hook it up to an HDMI display and any of 
your usual USB inputs at any time. 

► £238 / $259 

► magpi.cc/wpZiSS 
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REVIEW I 


LapPi 


See-through DIY 



This recent project from the 
folks at SB Components is 
a laptop that you not only 
build, but also see all the 
components inside when you’re done! It comes in various sizes with 
different audio solutions for all your budgetary needs. 


► From £119/$155 

► magpi.cc/igqsAs 


Mini Handheld Notebook 



Build from scratch 

This Adafruit project from the venerable 
Ruiz Bros lets you create a very tiny 
Pi laptop/netbook using a full-sized 
Raspberry Pi. You’ll need to source 
the parts individually, although that 
does mean you can switch them for 
alternatives as you see fit. 

► magpi.cc/vnCQJR 


Portable Pi Laptop 


Barebones build 

Designed by Pi Supply to make use of 
its versatile PiJuice battery module, 
this very simple build uses the bare 
minimum of elements to make a 
laptop-like design possible. And it 
works just as well as the Kano and 
RasPad kits do! 

► magpi.cc/SzyDbg 




Nano Pi2 UMPC 


Palm-sized laptop 

This is the smallest 'laptop' we've seen 
that makes use of a full-sized Raspberry Pi. 
It even features a neat clamshell design! 
Again, you’ll have to source all the parts 
to make it yourself. It’s well worth the 
effort, though. 

► magpi.cc/TUULny 


Piper Computer Kit 2 


The play-chest computer 

Another educational computer kit, the Piper computer is laid out like 
a Pi-powered laptop but uses the space more efficiently for storage 
and setting up fun programming tasks. You can just install Raspbian 
on it, though, if you wish. 

► £274 / $299 

► playpiper.com 



Lego Raspberry PiBook 



LAPTOP 
BUILDS AND 

IDEAS! 


► magpi.cc/FJawXH 


Dig out your bricks 

An oldie but a goodie 
- while this project 
was designed with the 
original Pi Model B in 
mind (with an updated 
Pi Zero version later), 
the setup is very easy to 
modify so that you can 
use a more powerful 
Raspberry Pi 3B+. 


If you fancy trying out 
B some other laptop 
building methods, take 
a look at The MagPi #74 

(magpi.cc/74) for our 

‘Build a laptop’ feature! 
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McitfPi I RESOURCES 


Everything you need to learn 

Game Development 


Here are some great sources for game-making tools and helpful tips from Mark Veinstone 


I 


Pygame and Pygame Zero 


Pygame community 
development originally 
started by 

Pete Shinners 

Pygame Zero created 
and maintained by 

Daniel Pope 


Price: 

Free 

■ magpi.cc/SkBPms 


Python 3 is available with the 
standard install of Raspbian. 

To get started writing games 
quickly on the Raspberry Pi, 
there are a couple of Python 
modules that you will want to 
investigate. The first, Pygame, 
provides all the functions you 
will need to create a game 
window, draw to the screen, 
get input from the player, play 
sounds - in fact, everything 
you will need for a good game. 
Pygame is quite a powerful 


module which does need a bit of 
setting up in your code, but this 
makes it very flexible. 

If you want an even quicker 
result, you can use the Pygame 
Zero module; this does all the 
setup behind the scenes and 
you can have your program 
running with just a few lines 
of code. Pygame Zero takes 
care of most of the graphics 
handling and input with very 
simple functions, and can 
be combined with Pygame 



if needed. Both Pygame and 
Pygame Zero have had a tutorial 
series in The MagPi, which 
introduces all the capabilities of 
both modules. Start reading at 
issue 31 for Pygame, and issue 71 
for Pygame Zero. EH 


Game assets 


I 


Places to get graphics, sounds, and models 


TURBO SQUID 

Turbo Squid provides a huge range 
of 3D models and textures, both free 
and paid for, and includes some 
very high-quality assets for all types 
of games. Suitable for beginners to 
seasoned professionals. 
turbosquid.com 

OPEN GAME ART 

Community-provided graphics, models, 
and sounds. Most of the assets are 
provided under the Creative Commons 


or GPL licences. A great resource for 
getting together prototype ideas and 
supporting the artists. 

opengameart.org 

FREESOUND.ORG 

A searchable community-curated 
database of Creative Commons sounds. 
Here you will find both sound effects 
and also background music for your 
games. Most will require you to credit 
the author if you publish your game. 
freesound.org 
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RESOURCES I 


I Sploder 


Community 
developed and run 


Price: 

Free 


■ sploder.c 


If you are more into designing 
games than coding them, 
then you will find Sploder very 
interesting. It is an online game 
builder for creating games 
without coding. You can start 



with one of the many templates 
provided, and add graphics and 
sound from the Sploder libraries, 
or use your own. When you 
have finished your game, you 
can share it with your friends or 
even enter it into competitions. 
Because the game is played in 
a browser, it means that even 
if you make your game on a 
Raspberry Pi, it can be played on 
other types of computers or even 
mobile devices. There is lots 
of help on the website and the 
forums, and making your first 
game is only a few clicks away. ED 


AppGameKit 


The Game 
Creators Ltd 


Price: 

Raspberry Pi and 
schools: Free 
Other versions: 

£ 6 o/$ 8 o, with add-ons 
from £20/$25 

magpi.cc/sZRSye 



Here's one for the slightly 
more advanced game creators. 

AppGameKit has been available 
for some time on the PC, along 
with its companion product, 
GameGuru. Now AppGameKit 
is available for the Raspberry 
Pi to build 2D and 3D games. 
The kit itself is a toolbox for 
game creation, including a code 
editor, and lots of example 
programs to get you started. 


The language used is a form 
of BASIC, showing the kit’s 
heritage, originally developed 
by Lee Bamber, and called Dark 
Basic. The toolkit has moved on 
from then, and can be used to 
develop games that are cross¬ 
platform, including mobile. 
AppGameKit is flexible, suitable 
for writing publishable games, 
and many libraries of premade 
assets are available to buy. ED 


Learning 

resources 


I Resources for learning 
to write great games 



GETTING STARTED WITH 
PYTHON VIDEOS 

If you are right at the 
beginning of your game coding 
career, then here is a very 
straightforward video series 
showing how to get started 
programming Python on the 
Raspberry Pi. 
magpi.cc/BaiJvS 


RASPBERRY PI PRESS 
BOOKS 

You will find several books 
that cover aspects of game 
development from Raspberry 
Pi Press, but look for Make 
Games With Python, which will 
give you a comprehensive 
introduction to Python and 
Pygame game development, 
magpi.cc/gameswithpython 


RASPBERRYPI.ORG 

The main Raspberry Pi website 
has a wealth of game tutorials 
and examples. It covers 
making games with Scratch, 
Python, HTML, Minecraft, and 
extra hardware. This is a go-to 
resource if you are learning 
game development. 
magpi.cc/YtePEy 
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Nikole 

Vaughn 

Can you be on exec that also runs a CoderDojo for Girl Scouts? Nikole can 


> Category CoderDojo organiser | > Day job Executive Vice President 

> Website coderdojocoLLaborative.org 


▼ Hundreds of ninjas 
have taken part in the 
CoderDojo Collaborative 


U nlike a lot of event 
runners in the wider 
educational/Raspberry Pi 
community, Nikole never really 
planned to be one. 

“A local cybersecurity military 
non-profit group started the first 
known Dojos in San Antonio,” 
Nikole explains. “My kids and 
I [were invited] to join a Dojo 
to learn JavaScript. After two 
meeting dates, we received notice 
that the location was closing, and 


the Dojo needed a new gathering 
spot. I teach part-time for the 
University of Phoenix (UOP) 
in San Antonio, so the Dojo 
moved there for the remaining 
scheduled sessions. While sitting 
at UOP and checking-in the 
Ninjas, a realisation came to me: 
Tm now running the DojoP” 

She now runs her own 
CoderDojo with Malene 
Lawrence: the CoderDojo 
Collaborative at the San Antonio 


College, which has been its 
home for two years. 

“The atmosphere is 
collaborative and community 
focused,” Nikole tells us. 
“Everyone brings all of who 
they are and offers their talents 
to the group for the betterment 
of all involved.” 

What is your CoderDojo like? 

The CoderDojo Collaborative 
has 141 registered Ninjas, six 
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▲ Scratch is a popuLar topic for 
many students 

► There's about a 60/40 spLit 
between boys and girls at 
the Collaborative 


Champions 

needed! 


Think you have the 
skills to help young 
people learn coding 
and other kinds of 
digital making and 
computing? Then 
you could become a 
CoderDojo Champion 
and help shape the 
next generation of 
computer users. Head 
to the volunteer page 
for more details: 


Now Ninjas are learning 
how to create wearable and 
reactional Pi projects using 
LEDs. For interested Ninjas, 
one Mentor is teaching how 
to create a wearable WiFi hub 
using the Pi. 

The All About Me websites 
seem simple in concept, but 
really demonstrate the power 
of code. Ninjas bring their 
interests into the digital world 
using HTML, CSS, and JavaScript. 
One Ninja, who wanted to 
open a cupcake shop, created 
her own site with animated 
sprinkles falling from the sky 
onto cupcakes, while another 
Ninja created a site explaining 
his love of games like Minecraft. 
The Ninjas see that ideas in our 
natural world have life in the 
digital world. 

Other Ninjas created 70 
Scratch programs, ranging 
from an animated story book, 
to a ping-pong-like game, to 
a mathematical game to learn 
pre-algebra concepts. ED 


□ Everyone brings all of who they are 
and offers their talents to the group 
for the betterment of all involved □ 


nine weeks, then can register 
for a different topic after a 
Promotion Ceremony. 

How have kids reacted to 
the CoderDojo? 

Over the three years in operation, 
we have had 480 registered 
Ninjas. Kids show up ready 
to be cool and have fun. Our 
Ninjas often face the Saturday 
morning dilemma of having to 
choose between participating 
in a sporting event with a team, 


What are some of your 
favourite projects that have 
been made at the Dojo? Reply 
from Steven Bernstein , a Raspberry 
Pi Mentor at the Collaborative: 

It’s been projects that open the 
eyes of the kids to possibilities. 
Seeing the LED on the 
breadboard brighten for the 
first time, driven by code they 
entered themselves, is thrilling. 

Some Ninjas have composed 
and played music using 
Python on the Raspberry Pi. 


Volunteer Champions (Dee 
Arnold, Tracie Hervey, Sheri 
Brown, Shiketa Gresham, Malene 
Lawrence, and myself), 35 
Volunteer Professional Mentors, 
and 40 Non-technical Volunteers. 
We meet, for free, in nine 
dedicated spaces with computers 
at San Antonio College. We 
started with 20 Ninjas, two 
Champions, one Mentor, and no 
Non-Technical Volunteers. 

Ninjas choose one topic to 
cover for a period of eight to 


or coming to the Dojo. Parents 
are reporting that the Ninjas are 
choosing the Dojo more often, so 
are happy that we only meet two 
to three times per month, so that 
the kids can maintain their sports 
team position. 


coderdojo.com/ 

volunteer 


(4^ CoderDojo 
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This Month 

in Raspberry Pi 


Coolest Projects USA 

CoderDojo's spectacular event returns to Los Angeles to showcase 
amazing American youngsters 


B y the time you read this, it will be only 
a matter of days until Coolest Projects 
International on 5 May in Dublin, the 
premier Coolest Projects events held by 
CoderDojo. In late March, we had the privilege to 
see some of the incredible projects that students 
across America had made at Coolest Projects USA. EH 


01 . The Discovery Cube in LA is 
a fantastic science museum, 
and a perfect home for 
Coolest Projects 

02 . This huge auditorium was alive 
with the sounds of making 

03 . From magic mirrors to robots 
and Minecraft hacks, there was 
a huge range of projects 

04 . This is a very good rule for life 

05 . The classic American school 
science fair info board was 
the primary way peopLe were 
showing off their projects 

06 . Hundreds of people attended 
from across the United States 

07 . Judging was often a fun process 

08 . Rachel Pizzolato is a host on 
MythBustersJr, and drove 
overnight to be at the event 
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#MonthOfMaking 

Part 2 


More marvellous March makes! 


I ssue 80 went to print about halfway 
through March, meaning there was still 
loads of time left for people to get making 
for the #MonthOfMaking! Here are some more 
amazing pics of your projects... EH 


0 


Ed Martin 

I Mil l in IclIi 


r 


Just created a fruit piano' for toucan class to 
use in their #music lesson with 
@TTM@diaCompany this afternoon using a 

@ma keymakey. & M onthofMakmg 
#VenturersAc @VenturersTrust 


Izzy Bartley 


Who can resist this little #microbit 
micro:beastie? Look at her, she’s all 
heart (and eyes...)! 



#edtech 

#MonthOfMaking 



01 . We definitely can’t 
resist this cute 
micro:bit monster 

02 . Fruit piano sounds 
amazing. Is there a 
banana horn? 

03 . More beautiful Laser 
cutting. We want a 
Laser cutter now 

04 . Something as simple as 
a custom frame/case 
is a great way to make 


^ Makers pace Hu 11 

Cool stuff happening all the time here. This 
started life as a pencil sketch that we helped 
scan and convert to a scalable vector and it 
can now be laser cut or embroidered or 


anything... 
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Crowdfund this! 


Raspberry Pi projects you 
can crowdfund this month 




NanoSound DAC2 


Our friends at Nanomesher have a new DAC on 
Kickstarter: a new generation of their popular NanoSound 
DAC. It's been improved with better sound output and 
better components. We liked the originals, and we’re 
interested to see how the DAC2 turns out. 


► kck.st/2U60yre 



We love the idea of a tiny project that can just plug into 
a Pi so you can create an outdoor drive-in cinema with 
very little equipment. Or spruce up a weekend in a cabin 
by finding a blank wall to project onto. Anyway, this has 
already been funded, so might be worth jumping on. 


► kck.st/2FH1tq1 


Best of the rest! 

PI VIZUWALL 


Here are some other great things we saw this month 


FRIDGE SECURITY CAMERA 


FREEPLAY CM3+ 


Friend of the magazine, Estefannie 
Explains It All, notified us of this cool 
project at Miami Maker Faire. It's a cluster 
computer, and each Pi flares out as it uses 
more CPU power. Expect a bigger write-up 
in our next issue. 



► magpi.cc/jWMpPo 


Computer vision via OpenCV on a 
Raspberry Pi is very powerful. Powerful 
enough to help protect your food from 
sneaky thieves in shared accommodation 
or an office. Adrian built a device to keep 
his precious hummus safe from thieves. 



Your fridge was opened on 12 
Grimmauld Place at 
Wednesday, March 06 2019 at 
11:20AM for 8 seconds. 



This Game Boy Advance-esque retro 
gaming handheld is one of the first we've 
seen to implement a nice, low-profile dual 
analogue control setup. The D-pad looks 
pretty good as well. 


► magpi.cc/ixrRyK 


► magpi.cc/qEVGYz 
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01. LITORAL Raspberry JAM 

n Saturday 4 May 

Colon 206, Parana, Argentina 

► magpi.cc/JJpSUF 

An open access event where people can Learn about 
programming, electronics, and being creative. 


i 

Raspberry Jam 

Event Calendar 

Find out what community-organised Raspberry Pi-themed 
events are happening near you... 


05. May Exeter Raspberry Jam 

H Saturday 4 May 
® Exeter Library, Exeter, UK 
► magpi.cc/NqgSUC 

A monthly meeting for everyone interested in all things 
computers, microcontrollers, robotics, and making. 


02. Castro Valley Raspberry Jam 

n Saturday 4 May and Sunday 5 May 
$ Castro Valley Library, Castro Valley, CA, USA 

► magpi.cc/pYiwGm 

If you’re interested in coding, visit the Castro Valley Jam 
for tinkering, coding, electronics, and fun! 

03. AWC Informatics / STEDY Raspberry Jam 

H Monday 20 May 

® San Luis Middle School, San Luis, AZ, USA 

► codeyuma.org 

Arizona Western College and STEDY have partnered to 
bring a Raspberry Jam to Yuma County. 

04. Raspberry Jam Halifax 

n Friday 24 May and Saturday 25 May 
<$> Halifax West High School, Halifax, UK 

► magpi.cc/JJvzQq 

There will be Learning sessions, workshops, time to code, 
and time to share. 


06. Cornwall Tech Jam 

n Saturday 11 May 
® Bodmin Library, Bodmin, UK 

► cornwalltechjam.uk 

For anyone interested in technology, of all ages and 
abilities. Ask questions and learn about programming. 

07. Perth Raspberry Pi Jam 

□ Tuesday 14 May 
$ Spacecubed, Perth, Australia 

► magpi.cc/CwpHpd 

The May Talk invites you to bring your projects along to 
work on in a communal environment. 

08. Preston Raspberry Jam 

n Saturday 25 May 

Fulwood Library, Preston, UK 

► magpi.cc/ZaVRhB 

A free digital making event for all ages and skill Levels. 
Beginners welcome. 


FULL CALENDAR 

Get a full list of upcoming 
events for May and 
beyond here: 

rpf.io/jam 
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FIND OUT 
ABOUT JAMS 

Want a Raspberry Jam 
in your area? 

Want to start one? 
Email Ben Nuttall about it: 

jam@raspberrypi.org 


We've highlighted some of the areas 

i 

in need of a Jam! Can you help out? 




Raspberry Jam advice: 

Promotion 


"I 


use Twitter and Facebook. I’ve found it useful 
to get the message directly to schools who use 
Twitter, so the IT specialist can pass the 
message on to parents and children. I think ^ 0 
old-fashioned posters put up around the area 
work well too.” 

Anne Carhill - York Raspberry Jam 


Every Raspberry Jam is entitled to apply for a 
Jam starter kit, which includes magazine issues, 



printed worksheets, stickers, flyers, and more. 
Get the book here: magpi.cc/2q9DHfQ 
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Your 

Letters 



Ham question 

1 

1 

Power scale 



I was browsing through 
The MagPi #80 and found 
the ham radio section. I am 
especially interested in the 
aircraft detection setup. I would 
like to know what does it take to 
make something like this, other 
than the Pi and the PiAware 
software? Does it take a certain 
radio-to-USB dongle, or what 
other hardware is required? 

Also, does it require an internet 
connection to the Pi? 

Timon via email 

A lot of the ham radio projects 
do require a radio dongle and 
antenna of some kind so it 
can receive radio signals, and 
this project in particular is no 
different. It does, however, 
require an internet connection 
as well, so you need to make sure 
it's connected to your wireless 
network or have a mobile 
hotspot with you if you’re taking 
it into the wild. 


Contact us! 


Twitter @TheMagPi 
Facebook magpi.cc/facebook 
Email magpi@raspberrypi.org 

Online raspberrypi.org/forums 


Pm trying to figure out what 
the more powerful Raspberry Pi 
models are - is it generally the 
newer the better? Would that 
make the Raspberry Pi 3A+ the 
most powerful version? Where 
does the Compute Module fit in 
all this? 

Frances via email 

While ‘the newer the better’ 
is a pretty good rule of thumb, 
the model types (and price) also 
denote how ‘powerful’ they are. 
The Model B of a Raspberry Pi 
type is generally slightly more 
powerful than a Model A, as well 
as including more inputs and 
outputs and such. 


T The Raspberry Pi 3B-* 
is currently the most 
powerful Pi 


In the case of the 3B+ and the 
3A+, the 3B+ has lGB of RAM, 
while the 3A+ has 512MB. The 
3A+ doesn’t require as much 
power, though, and is a bit 
smaller, so it then comes down 
to what you need to use your 
Raspberry Pi for. The Pi Zero is 
smaller still, and only sports 
a single-core CPU, making 
it the least powerful of the 
current models. 

The Compute Module is 
generally as powerful as the 
Model B of the Pi generation 
it’s based on. 

If you want a full breakdown 
of the specs, head to our 
benchmark page for full details: 

magpi. cc/benchmarks 
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Subscription queries 


Is there a way I can find out 
when my The MagPi subscription 
runs out? It must be about now, 
which is reinforced by the fact 
that one hasn’t come through 
my door this week. Anywhere I 
can log in to check? 

Torcrayth from the forums 

You can check your subscription 
details by heading to your account 
page - you’ll find a link in the 
initial confirmation email for your 
subscription, and this applies 
for all print subscription types. 

If you don’t have that email, 
you should contact magpi@ 
subscriptionhelpline.co.uk and 
the folks there should be able to 
sort it out for you. 



Where to start 


I’m thinking of getting my 
eight-year-old their first 
Raspberry Pi - they’ve been 
playing with one at a friend’s 
house, and it seems like a great 
time to introduce them. What 
do you feel is a good starter kit 
for someone their age? 



Claire via Facebook 

There’s a couple of things we 
recommend for pretty much 
anyone to pick up if they want to 
get started with Raspberry Pi. 

The Official Starter Kit is 
definitely a great product 
to consider: it comes with a 
Raspberry Pi, keyboard, mouse, 
SD card, case, and the Official 
Raspberry Pi Beginner’s Guide. 


That’s 244 pages of expert tips 
that will help you make the most 
out of your new kit. 

For a slightly cheaper option, 
you should check out the Official 
Raspberry Pi Beginner’s Book 
(magpi.cc/beginners-book) 

- this comes with a Raspberry 
Pi Zero, SD card, case, and the 
adapters to connect it up. Both 
options are great, so go with 
what your budget allows! ED 


Up to 192kHz/24bit 

Connect existing audio 
equipment and stream 
music over the network 

Create a Karaoke box 

Use the Raspberry Pi as 
an effects processor 

Record audio 

Create a web radio station 


DAC+ADC 

Play back your music. 
And record it. 
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lYJ VCl One of ten 

HiFiBerry 

DAC+ ADC 


Last issue (magpi.cc/8o) we put 
together an amazing karaoke 
machine that used on of these 
wonderful DAC+ ADCs. Now is 
your chance to win one. We have 
ten DAC+ ADCs to give away. 


□ The DAC+ ADC not only 
offers your high-quality music 
playback on the Raspberry Pi, 
but also allows you to record sound 
from an analogue audio source □ 

- HiFiBerry 




In association with 

; HiFiBerry 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/dQKrSL 


Terms & Conditions 

Competition opens on 24 April 2019 and closes on 30 May 2019. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, the 
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don’t like spam: participants’ details 
will remain strictly confidential and won’t be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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on video games 
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The kids are alright 

The MagPi Features Editor Rob Zwetsloot is happy to find younger makers flourishing 


*ve been writing about computers 
and making for over seven years 
now, much of that revolving 
around the Raspberry Pi. I think 
I’ve done some great stuff, and I’m 
especially proud of the work we do 
here in The MagPi to help inspire 
folks to get stuck in with digital 
making and programming, and 
building circuits and such. 

If you told me at 16 that I would 
be doing this for a living, I probably 


So I gave up on that and pursued a 
different career. 

Python to the rescue 

A few things happened in my early 
adulthood to send me down my 
current path. The biggest one was 
that as an engineering student 
at university, I was introduced to 
Python. For the first time, I actually 
learnt how to code and it was like a 
new world had been opened up to me. 


□ For the first time, I actually learnt how to 
code and it was like a new world had been 
opened up to me □ 


wouldn’t have believed you. First of all, 
I’d already decided writing for a living 
wasn’t for me. Secondly, and most 
importantly, computing education 
when I was at school was complete 
trash. I joke to this day that I have 
a GCSE in Microsoft Office because 
honestly... that’s what the curriculum 
was. Learn mail merge. Create a 
spreadsheet. Do some HTML. Build 
a database. I remember desperately 
wanting to learn to code and seeing 
that Visual Basic was an option to learn, 
but my teacher refused my request. 


Since first learning to print ‘Hello 
World’ in Python, I’ve written 
silly games, visual novel engines, 
automated drones, created cosplay 
electronics, and much, much more 
with it. Things that, at 16 ,1 thought 
I’d never be able to do. 

I personally try to live life without 
regrets - who knows what amazing 
thing in my current life I’d lose if 
I’d done something significantly 
different? However, I am sad that I 
never got the chance to experiment 
with this kind of stuff as a kid. 


If you’ve ever met me and asked 
me about my job, I’ve probably 
already told you the above story. 
Twice, possibly (I’m very sorry). I 
always cap it by saying that I am 
honoured to work with Raspberry Pi 
to help young people do what I could 
not, and that was never more evident 
than spending a day at a CoderDojo 
Coolest Projects event last month. 

A new era 

In this room full of makers ranging 
from 10 to 18,1 saw incredible 
projects that put myself, and other 
makers, to shame. These kids and 
teens are getting to flex their creative 
muscles in an entirely different way, 
and it’s all made possible thanks to 
new and improved resources, and a 
ton of affordable hardware to help 
them achieve their tech dreams. 

If what I do helps to inspire these 
people in even the slightest way, it 
makes all the hard work we put into 
The MagPi more than worth it. EH 


L 


Rob Zwetsloot 


Rob is amazing. He's also the Features 
Editor of The MagPi, a hobbyist maker, 
cosplayer, comic book writer, and 
extremely modest. 
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RASPBE 


LEARN 

COMPUTING 

THE EASY WAY! 

Includes 

Pi Zero W computer 
Official case with three covers 
USB and HDMI adapters 
8GB microSD card 
116-page beginner’s book 


Buy online: magpi.cc/store 












Kit Includes 


a TM 

Cano Kit 




Learn to: 

* Build your own credit card 
sized computer 

^ Get started with programming 

^ Set up a Media Center 
^ Make simple electronic circuits 

Includes: 

^ Raspberry Pi board and case 
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Pl3 Included! 


Raspberry Pi 

For Dummies Booklet 

u* Raspberry Pi 3 Board 

Memory Card 

u* Plastic Case 

u* 2.5A Power Supply 

HDMI Cable 

u* Resistors 

LEDs 

v* Push Button Switches 
u* Prototyping Breadboard 
v* Jumper Wires 
u* Heat Sinks 



Available for worldwide shipping at: 

WWW.CANAKIT.COM 


Available in Europe 
through RS Components 


m 




$89" £69" 

US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 
a registered trademark of RS Components Ltd. CanaKit is a registered 
trademark of Cana Kit Corporation. 
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